VS Code Insiders调试Qt6 C++代码时复杂局部变量显示为空

问题现象 #

在VS Code Insiders中调试Qt6 C++代码时：

• int、bool等基础类型局部变量显示正常
• QString这类复杂局部变量显示为空
• 类成员变量可正常展示
  相同代码在Eclipse CDT调试时，所有变量均能正常显示。

当前launch.json配置 #

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/gitStatus",
            "args": ["--verbose"],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description":  "Set Disassembly Flavor to Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        },
    ]
}

解决方案 #

1. 加载Qt6的GDB专用打印脚本 #

Qt复杂类型（如QString）需要专用的pretty printer才能在GDB中正确解析显示。修改launch.json的setupCommands，添加加载Qt6打印脚本的命令：

"setupCommands": [
    {
        "description": "Enable pretty-printing for gdb",
        "text": "-enable-pretty-printing",
        "ignoreFailures": true
    },
    {
        "description": "Load Qt6 pretty printers",
        "text": "source /usr/share/qt6/misc/gdb/printers.py",
        "ignoreFailures": false
    },
    {
        "description": "Set Disassembly Flavor to Intel",
        "text": "-gdb-set disassembly-flavor intel",
        "ignoreFailures": true
    }
]

如果找不到printers.py，可以用以下命令查找实际路径：

find / -name printers.py | grep qt6

将查到的路径替换到source命令中即可。

2. 检查编译优化配置 #

确保编译时添加了调试信息并关闭过度优化，避免局部变量被编译器优化掉。例如在CMakeLists.txt中添加：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -Og")

其中-g用于生成调试信息，-Og保留调试友好的最低优化级别。

3. 验证GDB版本兼容性 #

确保使用的GDB版本支持Qt6，推荐使用GDB 10及以上版本，可通过以下命令查看版本：

gdb --version

内容的提问来源于stack exchange，提问作者jschwartzman