VSCode配置C++环境需先安装编译器（如g++/clang++/cl）并加入PATH，再安装微软官方C/C++扩展；自动探测失败时手动配置c_cpp_properties.json的compilerPath和intelliSenseMode；最后通过tasks.json（含-g）和launch.json实现编译调试。

VSCode 本身不带 C++ 编译器，所谓“配置 C++ 环境”，本质是：装好编译器（如 g++ 或 cl.exe），再让 VSCode 找得到它，并能调用它来编译、调试。没装对编译器，后续所有配置都白搭。

确认系统已安装可用的 C++ 编译器

VSCode 不会替你装编译器，必须先手动安装并验证命令行可用。

• Windows 用户优先选 MinGW-w64（轻量、跨平台友好）或 Visual Studio Build Tools（微软官方、兼容性好）。装完后必须把 bin 目录加进系统 PATH，然后在终端运行 g++ --version 或 cl 看是否返回版本信息
• macOS 用户直接运行 xcode-select --install 安装命令行工具，之后 clang++ --version 应有输出；不要依赖 Xcode GUI 自带的完整 IDE
• Linux 用户通常自带 g++，但需确认：运行 sudo apt install build-essential（Ubuntu/Debian）或 sudo yum groupinstall "Development Tools"（CentOS/RHEL）
• 别跳过验证步骤——很多人卡在“找不到 g++”，其实是 PATH 没生效，或安装时勾选了“不添加到 PATH”

安装 VSCode 官方 C/C++ 扩展（不是 C++ Runner）

微软官方扩展叫 C/C++（作者 Microsoft），ID 是 ms-vscode.cpptools。它提供智能提示、跳转、调试支持；而第三方 C++ Runner 类扩展只是封装了简单编译命令，掩盖问题、难调试、不推荐新手用。

• 在 VSCode 扩展市场搜 C/C++，认准图标和作者，点安装
• 安装后重启 VSCode，打开一个 .cpp 文件，状态栏右下角应显示当前使用的编译器（如 GCC x.x.x）——这是扩展自动探测的结果
• 如果没显示或显示 Unable to detect compiler，说明前面编译器没装好或 PATH 有问题，此时别急着配 c_cpp_properties.json
• 该扩展依赖 cpptools-srv 后台进程，首次启用可能卡顿几秒，属正常现象

生成并修改 c_cpp_properties.json（仅当自动探测失败时）

这个文件控制头文件路径、宏定义、标准版本等，不是编译开关，也不是运行入口。90% 的新手误以为改了它就能“运行 C++”，其实它只影响代码分析（比如 #include 是否标红）。

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 C/C++: Edit Configurations (UI)，回车——它会自动生成 .vscode/c_cpp_properties.json
• 关键字段是 "compilerPath"：必须填绝对路径，例如 "C:\\msys64\\mingw64\\bin\\g++.exe"（Windows）或 "/usr/bin/clang++"（macOS），不能写 "g++"
• "intelliSenseMode" 要和编译器

  

  匹配：用 g++ 就选 gcc-x64，用 clang++ 就选 clang-x64，否则头文件识别错乱
• 改完保存，VSCode 右下角会提示“IntelliSense 已重新加载”，等待几秒再看语法提示是否恢复

用 tasks.json 和 launch.json 实现一键编译+调试

VSCode 运行 C++ 不靠插件按钮，而是靠两个 JSON 配置文件驱动终端命令和 GDB/LLDB 调试器。它们必须放在项目根目录的 .vscode/ 下，且文件名不能拼错。

• tasks.json 定义怎么编译：核心是 "args" 数组，确保包含 "-g"（生成调试信息）、"-o"（指定输出文件），例如：["-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}.out"]
• launch.json 定义怎么调试：关键是 "program" 字段要指向 tasks.json 编译出的可执行文件路径，且 "miDebuggerPath" 必须填对（如 "C:\\msys64\\mingw64\\bin\\gdb.exe"），否则点 ▶️ 会报 Cannot launch program
• 调试前务必先运行一次构建任务（Ctrl+Shift+B），否则 launch.json 指向的是不存在的文件
• Mac/Linux 用户注意：launch.json 中 "externalConsole" 设为 false 才能在集成终端看到 cin 输入；设为 true 会弹新窗口，VSCode 无法捕获其输入

最常被忽略的点：编译器路径写相对路径、漏掉 -g、launch.json 的 program 指向源文件而非可执行文件、调试前没构建。这些错误不会报明显异常，只会静默失败或断点无效——检查时优先盯住这三个字段。