program路径错误、miDebuggerPath未配置或错误、preLaunchTask名称不匹配、编译未加-g参数是导致VS Code调试失败的四大主因，需逐一验证。
launch.json 里 program 字段指向的文件根本不存在
断点变灰、F5 后提示 “Program does not exist” 或直接无响应，八成是 program 路径写错了。VS Code 不会帮你创建可执行文件，它只认你编译后真实存在的二进制。
常见错误包括：
-
program写成"${workspaceFolder}/a.out"，但 tasks.json 实际输出的是main.exe（Windows）或hello（Linux/macOS） - Windows 下漏掉
.exe后缀，比如写成"${fileDirname}/${fileBasenameNoExtension}"，而实际生成的是main.exe - 路径中用了单反斜杠
，JSON 解析失败，必须双写为\，例如"${fileDirname}\${fileBasenameNoExtension}.exe" - tasks.json 把文件输出到
build/目录，但program还在用${workspaceFolder}，没同步改路径
验证方法：在 VS Code 集成终端里手动执行 ls ${fileDirname}/main.exe（Windows）或 ls ${fileDirname}/main（Linux/macOS），看文件是否存在。
miDebuggerPath 没填或填错，GDB 根本没启动
VS Code 不会从系统 PATH 自动找 gdb，miDebuggerPath 是唯一入口。填错、路径不存在、权限不足，都会卡在 “launching…” 或报 Could not find the debugger executable specified in 'miDebuggerPath'。
立即学习“C++免费学习笔记（深入）”；
正确做法：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- Windows 用户必须填
gdb.exe的**绝对路径**，如"D:\msys64\usr\bin\gdb.exe"或"C:\mingw64\bin\gdb.exe"；不能只写"gdb"或"gdb.exe" - macOS/Linux 用户若用
lldb，也要填完整路径，如/opt/homebrew/bin/lldb；别信“自动发现”，它不工作 - 右键检查该路径下是否真有可执行文件——在资源管理器或 Finder 中打开目录，确认
gdb.exe或gdb文件存在且非灰色图标
preLaunchTask 名称和 tasks.json 的 label 对不上
F5 时弹出 Could not find task 'xxx'，说明 preLaunchTask 字符串和 tasks.json 里某个 label 不完全一致。VS Code 是严格字符串匹配，大小写、空格、标点一个都不能差。
典型翻车现场：
-
tasks.json里写的是"label": "g++ build active file"，但launch.json填了"preLaunchTask": "build" -
label是"Build C++"，preLaunchTask却写成"build c++"（大小写错） - 任务名带中文空格（如
"编译"），但复制时不小心多了一个全角空格
建议：label 全小写+短横线，如 "build-cpp"，然后 preLaunchTask 也照抄，避免歧义。
没装调试器或没加 -g 编译参数，断点永远无效
即使 program 和 miDebuggerPath 全对，只要可执行文件没带调试符号，断点照样灰。这不是 launch.json 的问题，而是构建环节就漏了。
关键检查点：
- 终端里运行
gdb --version（Linux/macOS）或gdb.exe --version（Windows），确认调试器已安装且可用 -
tasks.json的args数组里必须含"-g"，这是生成调试信息的开关；漏掉它，g++ main.cpp -o main输出的main就是“不可调试”的 - 别依赖 Code Runner 插件一键运行——它不走
tasks.json，默认不加-g，调试时必然失败
最稳妥的验证方式：用命令行手动编译一次，比如 g++ -g main.cpp -o main，再用 gdb ./main 看能否进调试器、能否 list 出源码。能，说明环境没问题；不能，回头查 g++ 和 gdb 是否真可用。
program 指向的文件是否真实存在、miDebuggerPath 是否精确到可执行文件、preLaunchTask 是否一字不差匹配、以及 -g 是否真的参与了编译——这四个点，任何一个松动，F5 就只是个摆设。 
