装对扩展和编译器是前提，VS Code需安装C/C++官方扩展并配置g++/clang++或MSVC；tasks.json和launch.json须匹配编译器路径、输出文件名及调试器类型，includePath仅影响IntelliSense不决定编译。
装对扩展和编译器是前提，不是可选项
VS Code 本身不带 C++ 编译和调试能力，c_cpp_properties.json 配得再漂亮，没装 g++ 或 clang++ 就根本跑不起来。Windows 用户尤其容易卡在这步——装了 VS Code，以为点一下就能跑，结果 build task failed: command 'g++' not found。
- Linux/macOS：确认终端里能直接运行
g++ --version或clang++ --version - Windows：别只装 Visual Studio，要勾选「使用 C++ 的桌面开发」工作负载；或者装 MinGW-w64 并把
bin/加进系统PATH - VS Code 扩展必须装
C/C++（Microsoft 官方，ID：ms-vscode.cpptools），其他“C++ Helper”之类花哨插件不能替代它
tasks.json 里 command 必须写对路径和参数
很多人复制网上的 tasks.json 示例，但没改 command 字段，导致构建时找不到编译器。比如 Windows 上用 MinGW，command 写成 "g++" 可能失败，因为没走 PATH，得写绝对路径或确保 shell 环境一致。
- 推荐写法：
"command": "g++"（依赖 PATH）+ 在options.env里显式补PATH，比硬编码路径更可移植 -
args别漏-g：没有它，launch.json调试时看不到变量、单步会跳过源码行 - 输出文件名统一用
${fileBasenameNoExtension}，避免手动改名导致launch.json启动失败 - 如果项目含多个文件，
args要列全，或改用"${fileDirname}/*.cpp"（注意 shell 展开行为在不同系统不一致）
launch.json 的 miDebuggerPath 和 program 必须匹配构建结果
调试启动失败最常见原因：生成的可执行文件名、路径和 launch.json 里写的 program 对不上；或者调试器路径压根没设，VS Code 默认找 gdb，但 Windows 上你装的是 gdb.exe（MinGW）或 vsdbg（MSVC），不指定就报错 Cannot launch program; spawn gdb ENOENT。
-
program值必须是构建后真实存在的文件路径，建议用${fileDirname}/${fileBasenameNoExtension}，和tasks.json输出保持一致 - Linux/macOS：通常不用设
miDebuggerPath，系统gdb自动识别；macOS M1/M2 若用 arm64lldb，需换用cppvsdbg类型并配pipeTransport - Windows + MinGW：显式设
"miDebuggerPath": "C:\mingw64\bin\gdb.exe"，路径用双反斜杠或正斜杠都行，但不能漏后缀 - 不要开启
externalConsole后又忽略控制台闪退问题——它默认用 cmd/powershell 启动，输入后直接关窗，加system("pause")是临时解法，不是调试逻辑的一部分
头文件路径和 IntelliSense 不报错 ≠ 编译能过
c_cpp_properties.json 里的 includePath 只影响代码提示和跳转，不影响实际编译。你看到 #include <vector></vector> 没红线，不代表 g++ 能找到它——尤其是跨平台或用了第三方库（如 OpenCV、Boost）时，tasks.json 的 args 里必须有对应 -I 和 -L，否则编译报 fatal error: xxx: No such file or directory。
立即学习“C++免费学习笔记（深入）”；
-
includePath和tasks.json中的-I参数要同步维护，别一个改了另一个忘了 - 使用
std::filesystem等 C++17 特性？tasks.json的args得加-std=c++17，光靠c_cpp_properties.json设"cppStandard": "c++17"不起作用 - IntelliSense 引擎（
default或clangd）选错会导致头文件解析异常，右下角状态栏点 C/C++ 图标可切换，遇到假报错先试试换引擎
调试器连上、断点能停、变量能看，不代表程序逻辑没错——但至少说明环境链路通了。最容易被忽略的是：每次换编译器（比如从 g++ 切到 clang++），tasks.json 和 c_cpp_properties.json 里所有路径、标准版本、扩展名（.exe vs none）、甚至调试器类型都得重新核对一遍。
