配置compile_commands.json后VSCode中Bazel C++断点失效

针对Windows10 + VSCode环境下，配置compile_commands.json后Bazel构建的C++程序断点失效、调试类型无法选择的问题，可按以下步骤排查修复：

1. 确保compile_commands.json被正确识别 #

VSCode的C/C++扩展需要明确指定compile_commands.json的路径，在.vscode/c_cpp_properties.json中添加配置：

{
    "configurations": [
        {
            "name": "Win32",
            "compileCommands": "${workspaceFolder}/compile_commands.json",
            "includePath": ["${workspaceFolder}/**"],
            "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
            "windowsSdkVersion": "10.0.22621.0",
            "compilerPath": "cl.exe",
            "cppStandard": "c++20",
            "intelliSenseMode": "windows-msvc-x64"
        }
    ],
    "version": 4
}

路径需与实际生成的compile_commands.json位置一致，若通过Bazel命令指定了输出目录，需对应修改。

2. 修正launch.json的调试配置 #

放弃bazel-launch-build类型，改用Windows兼容性更好的cppdbg调试类型，示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug manualTest",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/bazel-bin/test/manualTest.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "externalConsole": false,
            "MIMode": "vsdbg",
            "miDebuggerPath": "C:/Program Files/Microsoft Visual Studio/2022/Community/Common7/IDE/Extensions/Microsoft/Windows Debugger/vsdbg.exe",
            "preLaunchTask": "manualTest"
        }
    ]
}

• 若使用GCC工具链，将MIMode改为gdb，miDebuggerPath指向本地安装的gdb.exe路径。
• 确保program路径指向Bazel生成的调试版可执行文件。

3. 强化Bazel调试构建参数 #

在.bazelrc中补充禁用优化的参数，避免编译器优化导致断点失效：

build --cxxopt="/std:c++20"
build -c dbg
build --copt=-O0
build --linkopt=/DEBUG

• -c dbg确保生成调试信息，--copt=-O0禁用编译优化，--linkopt=/DEBUG强制链接时保留调试符号。
• 构建时可显式执行bazel build -c dbg //test:manualTest，确保参数生效。

4. 修复VSCode扩展兼容性问题 #

• 关闭VSCode，删除.vscode目录下可能存在的冲突配置文件（如settings.json中与C/C++、Bazel相关的冗余配置），重新打开项目。
• 更新Microsoft C/C++扩展和Bazel扩展至最新版本，避免版本不兼容导致的调试类型无法选择问题。

5. 验证可执行文件的调试信息 #

使用VS自带的dumpbin工具检查可执行文件是否包含调试符号：

dumpbin /SYMBOLS bazel-bin/test/manualTest.exe

若输出中包含大量符号信息，说明调试构建正常；若无符号输出，需重新检查Bazel构建参数是否正确。

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