VS Code 配置 C++ 开发环境需四步：1. 将 g++ 所在 bin 目录加入系统 PATH 并验证；2. 用 UI 工具生成 c_cpp_properties.json，正确设置 compilerPath 和 intelliSenseMode；3. tasks.json 中添加 -g 参数并设 "group": "build"；4. launch.json 必须指定 miDebuggerPath（如 gdb.exe 绝对路径）且 program 路径与输出一致。
VS Code 本身不带 C++ 编译器，也不能直接运行 C++ 程序，必须手动配好 gcc（或 g++）和 launch.json。配错一步，Ctrl+F5 就报 “Unable to start debugging” 或 “Program 'xxx' does not exist”。下面按真实踩坑顺序讲清楚关键点。
确认系统已安装可用的 g++ 并加入 PATH
VS Code 的终端和调试器都依赖系统 PATH 找 g++。很多人装了 MinGW 或 MSYS2，但没把 bin 目录加进环境变量，结果终端里能敲 g++ --version，VS Code 里却找不到。
- Windows 上推荐用 MinGW-w64（选 x86_64、posix、seh），解压后把
mingw64\bin加入系统 PATH - 在 VS Code 终端里执行
g++ --version和which g++（或where g++），确保有输出且路径合理 - 如果用 WSL，必须在 WSL 内安装
g++（sudo apt install build-essential），且 VS Code 要用 Remote-WSL 扩展打开项目，否则 Windows 版 VS Code 默认调用不到 WSL 的g++
c_cpp_properties.json：告诉 IntelliSense 头文件在哪
这个文件不参与编译，只影响代码补全和跳转。配错会导致 #include 报红，但程序仍能编译通过——这是最让人困惑的“假错误”。
- 用 Ctrl+Shift+P → “C/C++: Edit Configurations (UI)” 自动生成，比手写安全
-
"compilerPath"必须指向你实际的g++可执行文件（如"C:\\mingw64\\bin\\g++.exe"），不能只写"g++" -
"intelliSenseMode"根据你的架构选：gcc-x64（64 位）、gcc-x86（32 位），和compilerPath一致，否则头文件路径可能错位 - MinGW-w64 的标准头文件通常在
mingw64\x86_64-w64-mingw32\include和mingw64\lib\gcc\x86_64-w64-mingw32\*\include\c++，这些路径会由插件自动推导，一般不用手动填"includePath"
tasks.json：定义如何编译，关键在 "args" 和 "group"
这个文件决定你按 Ctrl+Shift+B 时发生什么。常见错误是参数顺序错、漏了 -g、或者没设 "group": "build" 导致构建任务不显示。
立即学习“C++免费学习笔记（深入）”；
- 必须包含
-g参数，否则launch.json无法调试（断点灰掉） -
"args"中"${file}"是当前编辑的 .cpp 文件，"-o"后跟输出路径，建议用"${fileDirname}\\${fileBasenameNoExtension}.exe"（Windows）或"${fileDirname}/${fileBasenameNoExtension}"（Linux/macOS） - 务必设置
"group": "build"，否则 Ctrl+Shift+B 不会列出该任务 - 示例片段：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}\\${fileBasenameNoExtension}.exe"
],
"options": {
"cwd": "${fileDirname}"
},
"problemMatcher": ["$gcc"],
"group": "build"
}
]
}
launch.json：调试启动配置，最容易漏掉 "miDebuggerPath"
Windows 下用 MinGW-w64 调试，必须显式指定 gdb 路径。VS Code 默认找 gdb，但 MinGW-w64 提供的是 gdb.exe，且不在 PATH 里——这就是为什么断点不命中、控制台一闪而退的根源。
-
"program"必须指向可执行文件（不是 .cpp），且该文件必须已存在（即先 Ctrl+Shift+B 成功） -
"miDebuggerPath"填完整路径，例如"C:\\mingw64\\bin\\gdb.exe"；不填或填错，调试器直接启动失败 -
"externalConsole"设为true（Windows），否则控制台输入/输出不可见 - 如果程序需要命令行参数，在
"args"数组里加字符串，如["input.txt", "output.txt"]
最常被忽略的是：launch.json 里的 "program" 路径必须和 tasks.json 输出的路径完全一致；miDebuggerPath 必须是 gdb.exe 的绝对路径，而不是 gdb 或相对路径；所有路径中的反斜杠在 JSON 里要双写（"\\\\"）。
