VS Code调试时变量默认十六进制显示，如何设为十进制？

Question

在使用 VS Code 进行 C/C++ 或嵌入式开发调试时，部分用户发现变量（尤其是指针、枚举或整型）在调试面板（如“Variables”或“Watch”窗口）中默认以十六进制显示，影响阅读和调试效率。尽管数值本身正确，但频繁的进制转换容易导致误判，尤其在处理普通整数逻辑时更为不便。开发者常问：如何将 VS Code 调试器中变量的默认显示格式从十六进制改为十进制？是否存在全局设置或 launch.json 配置项可实现此切换？该问题常见于使用 GDB 或 Cortex-Debug 等调试扩展的场景，亟需明确的配置方案。

Answer 1

如何在 VS Code 调试中将变量显示格式从十六进制改为十进制？

1. 问题背景与现象描述

在使用 VS Code 进行 C/C++ 或嵌入式开发时，开发者普遍依赖其集成调试功能（如通过 GDB、Cortex-Debug 扩展）来监控变量状态。然而，许多用户反馈：整型变量、枚举值甚至指针地址在“Variables”或“Watch”窗口中默认以十六进制（hexadecimal）形式展示。

例如：

• int value = 100; 显示为 0x64
• enum State { INIT, RUN } state = RUN; 显示为 0x1
• 结构体成员或数组索引也常被强制转为 hex

这种行为虽然不影响程序逻辑，但显著降低调试可读性，尤其在处理大量数值逻辑或状态机时易造成误判。

2. 根本原因分析

该现象并非 VS Code 自身决定，而是由底层调试器（如 GDB）的输出格式策略驱动。GDB 默认对某些类型（特别是无符号整型、指针、枚举）启用十六进制显示，以方便内存分析和寄存器查看。

VS Code 的调试前端（Debug Adapter）接收 GDB 的 MI（Machine Interface）输出，并原样呈现，因此无法通过 UI 设置直接更改全局默认进制。

常见涉及的调试扩展包括：

调试扩展	底层调试器	是否受 GDB 格式影响
C/C++ Extension (MS)	GDB/LLDB	是
Cortex-Debug	OpenOCD + GDB	是
Native Debug	GDB	是
PlatformIO IDE	GDB via esptool/pyocd	是

3. 解决方案层级一：手动切换单个变量显示格式

最基础的方法是在“Watch”窗口中显式指定显示进制。GDB 支持使用 /f 格式符进行临时转换。

示例操作：

1. 在 Watch 窗口中添加变量：value
2. 修改为：value/d 表示十进制
3. 其他格式符：

格式符	含义
/d	有符号十进制
/u	无符号十进制
/x	十六进制
/t	二进制
/o	八进制
/c	字符
/f	浮点

4. 解决方案层级二：launch.json 配置初始化命令

可通过在 launch.json 中注入 GDB 初始化命令，批量设置常用类型的默认显示格式。

适用于 C/C++ 和 Cortex-Debug 场景。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Cortex Debug",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build/app.elf",
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/arm-none-eabi-gdb",
            "setupCommands": [
                {
                    "description": "Set default print format to decimal",
                    "text": "-exec interpreter-exec console \"set print elements 0\"",
                    "ignoreFailures": true
                },
                {
                    "description": "Disable hex for integers",
                    "text": "-exec interpreter-exec console \"set print address off\"",
                    "ignoreFailures": true
                },
                {
                    "description": "Set output radix to decimal",
                    "text": "-exec interpreter-exec console \"set output-radix 10\"",
                    "ignoreFailures": true
                }
            ],
            "externalConsole": false
        }
    ]
}

关键命令说明：

• set output-radix 10：将所有整数输出设为十进制
• set print address off：避免地址自动以 hex 显示
• set print elements 0：不限制字符串/数组打印长度

5. 解决方案层级三：GDB 配置文件自动化（.gdbinit）

更优雅的方式是创建项目级或用户级 .gdbinit 文件，统一管理调试器行为。

在项目根目录或 home 目录下创建：

# .gdbinit
set output-radix 10
set print pretty on
set print array on
set print object on
set print vtbl on
set print demangle on
set print address off

此配置将在每次启动 GDB 时自动加载（需确保未禁用安全策略）。

若遇到 Not confirmed 提示，可在终端执行：

echo "set auto-load safe-path /" >> ~/.gdbinit

6. 高级技巧：结合 DAP 协议动态控制变量格式

部分现代调试扩展（如最新版 Cortex-Debug）支持通过 DAP（Debug Adapter Protocol）发送自定义命令。

可在调试控制台中输入：

-var-set-format var@entry::state decimal

或使用 VS Code 命令面板执行：

• Debug: Set Variable Value Format
• 选择目标变量并设定为 “Decimal”

注意：此功能依赖前端实现，非所有扩展均支持。

7. 流程图：调试变量格式问题解决路径

graph TD
            A[变量显示为十六进制] --> B{是否仅个别变量？}
            B -->|是| C[在 Watch 中使用 /d 格式符]
            B -->|否| D[修改 launch.json setupCommands]
            D --> E[添加 set output-radix 10]
            E --> F[重启调试会话]
            F --> G{是否跨项目复用？}
            G -->|是| H[创建 .gdbinit 配置文件]
            G -->|否| I[保留项目内配置]
            H --> J[确保 auto-load 安全路径设置]
            J --> K[完成]
            I --> K

8. 注意事项与兼容性说明

尽管上述方法有效，但仍需注意以下限制：

• 指针仍可能显示为 hex：因指针本质是地址，GDB 通常强制 hex 显示，set print address off 可缓解但不完全消除
• 枚举类型：部分编译器生成的 DWARF 信息可能导致 GDB 视其为整数，从而应用 radix 设置
• LLDB 用户：需使用 settings set target.format.default int 等不同命令
• RTOS 环境：FreeRTOS/GDB 多线程调试中，变量上下文切换可能重置格式
• 性能影响：大数组以十进制显示可能增加解析延迟

9. 最佳实践建议

针对不同开发场景，推荐如下策略：

场景	推荐方案
临时调试单个变量	Watch 窗口加 /d
项目级统一需求	launch.json + setupCommands
团队协作或 CI 调试	提交 .gdbinit 到仓库
频繁切换格式	掌握 DAP 变量格式命令
嵌入式裸机开发	结合 cortex-debug 提供的 memory view 辅助