必须配置miDebuggerPath才能启动GDB，VSCode不自动识别系统gdb；需用which gdb或where gdb确认绝对路径，如/usr/bin/gdb或C:/mingw64/bin/gdb.exe，并在launch.json中显式指定，Windows路径须用正斜杠或双反斜杠。
launch.json 里必须配 miDebuggerPath 才能用 GDB
VSCode 默认不自动识别系统里的 gdb，哪怕你已安装 MinGW 或 Cygwin 或 WSL 的 GDB，launch.json 里不显式指定路径，调试器根本启动不起来，报错通常是：Could not find the task 'C/C++: g++.exe build active file'. 或更隐蔽的 Failed to launch gdb: command not found。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先在终端运行
which gdb（Linux/macOS）或where gdb（Windows CMD），确认 GDB 可执行文件绝对路径，比如/usr/bin/gdb、C:\msys64\mingw64\bin\gdb.exe、C:\tools\msys64\usr\bin\gdb.exe - 在
launch.json的configurations条目中，加一行："miDebuggerPath": "/your/path/to/gdb"（注意 Windows 路径用正斜杠或双反斜杠，别用单反斜杠） - 如果用的是 WSL，且 VSCode 连的是 WSL 环境，
miDebuggerPath必须填 WSL 内部路径（如/usr/bin/gdb），不能填 Windows 路径
program 字段必须指向已编译的可执行文件，不是 .cpp 源码
新手常把 "program": "${file}" 直接写进去，结果调试器报 Cannot debug binary: file not found 或直接卡在 “Starting” 状态。GDB 调试的是二进制，不是源码。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保已用
g++ -g编译出带调试信息的可执行文件，例如：g++ -g -o hello.exe hello.cpp -
"program"值设为输出路径，如"./hello.exe"或"${workspaceFolder}/build/hello"；推荐用${fileBasenameNoExtension}动态匹配，比如"./${fileBasenameNoExtension}" - 如果用了构建任务（
tasks.json），确保launch.json中的"preLaunchTask"名称和tasks.json里label完全一致，且该任务确实生成了目标文件
Windows 下 MinGW-GDB 调试失败大概率是路径/编码/权限三连坑
MinGW 的 gdb.exe 在 VSCode 里容易挂：闪退、断点不命中、变量显示 <optimized out></optimized>、甚至弹出“无法访问此文件夹”错误——这些基本不是配置写错了，而是环境链路出了问题。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 检查 GDB 版本是否太新：MinGW-w64 12+ 的 GDB 在旧版 VSCode（gdb 11.2 更稳
- 确保编译时加了
-g -O0（关优化），否则局部变量不可见；避免混用-m32/-m64和 GDB 架构不匹配 - VSCode 启动方式影响权限：如果用快捷方式启动，右键属性 → 兼容性 → 取消勾选“以管理员身份运行”，否则 GDB 无法注入进程
- 中文路径必炸：工作区路径、文件名、甚至 Windows 用户名含中文，GDB 会解析失败，一律改英文路径
调试时看不到变量值？先查 setupCommands 和 stopAtEntry
断点能停，但 hover 看不到变量、Debug Console 里 print var 报 Can't find symbol，大概率是 GDB 初始化没配对，或者入口没停住就跑飞了。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在
configurations里加上标准初始化命令块："setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ] - 加
"stopAtEntry": true，确保第一行就停住，方便验证调试器是否真正接管了程序流 - 如果用了 CMake Tools 插件，优先用它自动生成的
launch.json（通过命令面板 → “CMake: Debug”），它会自动填好符号路径、miDebuggerPath、environment等细节，比手写可靠得多
