VS Code 配置 C++ 环境需三步：安装编译器（如 MinGW-w64/xcode-select/build-essential）并配置 PATH；安装官方 C/C++ 扩展，生成并正确设置 c_cpp_properties.json；配置 tasks.json 实现编译、launch.json 实现调试。
VS Code 本身不是 IDE，它不自带 C++ 编译器或构建系统，所以“配置 C++ 环境”本质是：装好编译器 + 配置 tasks.json 调用它 +（可选）用 c_cpp_properties.json 告诉 IntelliSense 头文件路径。没装编译器，其他全是空转。
确认已安装可用的 C++ 编译器
VS Code 不提供编译器，你必须自己装。Windows 推荐 MinGW-w64（轻量、免 VS 安装），macOS 用 xcode-select --install 装命令行工具，Linux 直接 sudo apt install build-essential（Ubuntu/Debian）或 sudo dnf groupinstall "Development Tools"（Fedora）。装完必须能在终端里运行：
g++ --version
如果报 command not found，说明没加进 PATH，VS Code 打开方式也得注意——不能从开始菜单点开，要从已配置好 PATH 的终端里执行 code .，否则它读不到你的编译器。
- MinGW-w64 下载地址是 https://www.mingw-w64.org/downloads/，别用过时的 TDM-GCC 或旧版 MinGW
- Windows 上装完务必把
mingw64/bin（或你解压路径下的对应bin）加进系统环境变量PATH - VS Code 启动后，按
Ctrl+Shift+P输入Developer: Show Logs→ 选Window，搜PATH看它实际加载了哪些路径
安装 C/C++ 扩展并生成 c_cpp_properties.json
只装 Microsoft 官方的 C/C++ 扩展（ID：ms-vscode.cpptools），别装带“C++ Intellisense”字样的第三方扩展，它们常和官方扩展冲突。装完打开一个 .cpp 文件，右下角会提示“无法找到 compile_commands.json 或 c_cpp_properties.json”，点“Generate C/C++ Configurations”：
立即学习“C++免费学习笔记（深入）”；
- 它会创建
.vscode/c_cpp_properties.json，关键字段是"compilerPath"，必须指向你真实的g++.exe（如"C:\\mingw64\\bin\\g++.exe"），不能留默认的/usr/bin/gcc -
"intelliSenseMode"根据编译器选：gcc-x64（MinGW-w64 64 位）、gcc-x86（32 位）、clang-x64（macOS） - 如果项目用了第三方库（如 OpenCV），把头文件路径加到
"includePath"数组里，比如"C:/opencv/build/install/include/**"
用 tasks.json 实现一键编译
VS Code 运行 C++ 不靠“运行按钮”，而是靠任务（Task）调用 g++。按 Ctrl+Shift+P 输入 Tasks: Configure Task → 选 Create tasks.json file from template → Others。替换内容为：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"group": "build",
"problemMatcher": ["$gcc"]
}
]
}
这个任务会编译当前打开的 .cpp 文件，生成同名可执行文件。要点：
-
"problemMatcher": ["$gcc"]是关键——它让编译错误能直接跳转到出错行，没它就只能看终端输出 - 如果项目有多个源文件，把
"${file}"换成所有.cpp路径，比如"src/main.cpp"、"src/utils.cpp" - 需要链接库时，在
"args"里加-l和xxx-L/path/to/lib - 按
Ctrl+Shift+B就触发编译；失败时看终端面板的“Tasks”页，别只盯着右下角小弹窗
调试前必须生成 launch.json 并检查 program 路径
调试依赖编译产物，所以先确保 tasks.json 成功生成了可执行文件。再按 Ctrl+Shift+P 输入 Debug: Open launch.json → 选 C++ (GDB/LLDB) → g++.exe。修改 "program" 字段，指向你编译出的文件，例如：
"program": "${fileDirname}/${fileBasenameNoExtension}"
常见坑：
-
"miDebuggerPath"必须设对：MinGW-w64 是"C:\\mingw64\\bin\\gdb.exe"，没设就会报Cannot find GDB - Windows 下如果程序一闪退，勾选
"externalConsole": true，否则控制台关太快看不到输出 - 调试多文件项目时，
"program"路径必须和tasks.json中-o输出路径严格一致
最易被忽略的一点：每次改完 tasks.json 或 c_cpp_properties.json，都得重启 VS Code 窗口（不是重载窗口），IntelliSense 和任务系统才真正重新加载配置。
