调试失败的根本原因是编译器未生成带调试信息的可执行文件，需在tasks.json中手动添加-g和-o参数，并确保编译器、调试器在PATH中且配置一致。

tasks.json 里漏了 -g 或 -o，调试必然失败——不是 VSCode 有问题，是它根本没生成带调试信息的可执行文件。

确认编译器和调试器真正在 PATH 里

VSCode 不自带 g++、gcc 或 gdb，所有配置都建立在“命令能被终端直接调用”的前提上。

• Windows：打开 CMD（不是 PowerShell），运行 g++.exe --version 和 gdb.exe --version；若报“不是内部或外部命令”，说明 MinGW 的 bin 目录没进系统 PATH，或你装的是精简版（如某些 MinGW-installer 漏注册）
• macOS：终端执行 which clang++ 和 which lldb；Xcode 自带的 clang++ 默认不带 libstdc++，std::filesystem 会链接失败，建议用 Homebrew 装的 g++-14 并在配置中显式指定路径
• Linux：运行 g++ --version 和 gdb --version；注意多版本共存时（如 g++-11、g++-13），c_cpp_properties.json 中的 compilerPath 填哪个，IntelliSense 就按哪个标准解析头文件，但 tasks.json 仍可能调用默认 g++——两者不一致会导致头文件提示正常、编译却报错

tasks.json 必须手动补全 -g 和输出路径

VSCode 自动生成的模板常缺关键参数，尤其 -g（生成调试符号）和 -o（指定输出文件名），这两项一漏，launch.json 就找不到可调试目标。

• "args" 至少得包含："-g"、"${file}"、"-o"、"${fileDirname}/${fileBasenameNoExtension}"；Windows 下不用加 .exe 后缀，VSCode 会自动处理
• 多文件项目别硬塞进单文件 tasks.json：比如加一堆 "${fileDirname}/a.cpp"、"${fileDirname}/b.cpp"，维护爆炸；应改用 Makefile 或 CMake，然后让 tasks.json 调用 make 或 cmake --build
• "problemMatcher": ["$gcc"] 必须保留——否则编译错误只能看终端滚动文字，无法双击跳转到出错行
• MinGW 用户注意：args 里别加 -static-libgcc -static-libstdc++，除非真需要静态链接；否则容易触发 undefined reference to `WinMain'，因为链接器误判为 Windows GUI 程序

launch.json 的 program 和 preLaunchTask 必须严格匹配

调试启动失败最常见的原因是 program 指向的文件根本不存在，或者存在但没调试信息——这通常是因为 preLaunchTask 没触发、触发了但编译失败、或输出路径和 program 写的不一致。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• "program" 值必须和 tasks.json 中 -o 指定的路径完全一致，例如："${fileDirname}/${fileBasenameNoExtension}"；如果 tasks.json 输出的是 a.out，这里就不能写 main
• "preLaunchTask" 必须等于 tasks.json 中对应 task 的 "label" 字段值（大小写敏感），比如 task 的 label 是 "g++ build active file"，那这里就得填一模一样的字符串
• Windows 下若程序需要用户输入，"externalConsole" 得设为 true；设成 false 会导致调试时卡在输入环节，光标不动也不报错
• macOS 用 lldb 时，setupCommands 里建议加一条 {"description": "Enable pretty-printing", "text": "-enable-pretty-printing", "ignoreFailures": true}，否则 std::vector 这类容器只显示内存地址，不展开内容

c_cpp_properties.json 配完要手动“重新扫描”

这个文件管 IntelliSense（智能提示、跳转、宏定义识别），但它不会监听变更自动刷新。改完 compilerPath 或 includePath 后，不手动触发，头文件依然报红、#define 不生效。

立即学习“C++免费学习笔记（深入）”；

• 改完后，按 Ctrl+Shift+P → 输入 C/C++: Reset IntelliSense Database，或更直接地选 C/C++: Reinstall IntelliSense Engine
• "intelliSenseMode" 必须和实际编译器匹配：GCC 用 gcc-x64，Clang 用 clang-x64；配错会导致 __cplusplus 宏值异常、STL 头文件路径解析失败
• 如果项目用了第三方库（如 Boost、OpenCV），仅靠 "includePath" 不够，还得在 tasks.json 的 args 里加 -I 和 -L 参数，否则编译阶段就过不去

最常被忽略的一点：VSCode 的 C/C++ 扩展本身不参与编译或调试执行，它只是把 JSON 配置“翻译”成 shell 命令去调用系统工具。所以任何报错，第一反应不该是“VSCode 坏了”，而是打开终端，照着 tasks.json 的 command 和 args 手敲一遍，看是否能跑通。