VSCode需外部工具链及正确配置三类JSON文件才能实现C++编译调试闭环；Windows用x86_64版MinGW-w64并设"intelliSenseMode":"gcc-x64"；macOS需安装Xcode命令行工具并设clang路径与架构；Linux需手动添加g++头文件路径；launch.json必须配置miDebuggerPath且程序名与tasks.json输出一致。
VSCode 本身不自带 C++ 编译能力，必须靠外部工具链 + 正确配置 c_cpp_properties.json、tasks.json 和 launch.json 才能完成编辑→编译→调试闭环。配置失败的主因不是插件没装，而是路径、架构或环境变量没对上。
Windows 下用 MinGW-w64：别只装 x86 版本
很多教程推荐下载 MinGW-w64，但默认安装器常默认勾选 i686（32 位），而 VSCode 的 C/C++ 插件（ms-vscode.cpptools）在较新版本中默认期望 x86_64 工具链。若编译时报错：g++.exe: error: unrecognized command-line option '-m64'，大概率是混用了 32 位 g++ 和 64 位配置。
- 下载时明确选
x86_64-posix-seh（推荐）或x86_64-win32-seh，避开i686 - 把
mingw64\bin加入系统PATH，重启 VSCode 终端确认g++ --version输出含x86_64 -
c_cpp_properties.json中的"intelliSenseMode"必须设为"gcc-x64"，不能写"gcc-x86"
macOS 上用 clang++：注意 Xcode Command Line Tools 不等于 Xcode
macOS 自带 clang，但头文件和 SDK 路径依赖 Xcode Command Line Tools。只装了完整 Xcode 而没运行过 xcode-select --install，或装了 CLT 但没执行 xcode-select --switch /Library/Developer/CommandLineTools，会导致 IntelliSense 找不到
- 运行
xcode-select --install安装命令行工具（约 150MB） - 运行
xcode-select -p确认输出是/Library/Developer/CommandLineTools -
c_cpp_properties.json中"compilerPath"设为"/usr/bin/clang++"，"intelliSenseMode"设为"clang-x64"（Apple Silicon 用"clang-arm64"） - 如用 Homebrew 安装的 gcc（如
gcc-13），路径是/opt/homebrew/bin/g++-13，且需手动指定"includePath"到其头文件目录
Linux（Ubuntu/Debian）：g++ 头文件路径藏得深
Ubuntu 安装 g++ 后，#include 这类扩展头文件可能标红，因为 C/C++ 插件默认没包含 /usr/include/c++/11（或对应版本）下的子路径。这不是编译错误，是 IntelliSense 路径缺失。
立即学习“C++免费学习笔记（深入）”；
- 先确认 g++ 版本：
g++ --version→ 得到类似11.4.0 - 查头文件位置：
echo | g++ -E -Wp,-v -，看输出里/usr/include/c++/11是否在搜索路径中 - 在
c_cpp_properties.json的"includePath"数组里显式加一行："/usr/include/c++/11/**"（版本号按实际替换） -
tasks.json中args建议加"-std=c++17"或更高，避免默认 C++98 导致新语法报错
通用陷阱：launch.json 的 miDebuggerPath 容易被忽略
即使编译成功，点击调试按钮仍报 Unable to start debugging. Launch program not specified. 或 Cannot launch program ... because corresponding debug adapter is not found，常见原因是没配好调试器路径，尤其 Windows 下 MinGW 用户常漏掉这步。
- 确保已安装
C/C++插件（ms-vscode.cpptools）和C++ TestMate或CodeLLDB（非必须，但调试依赖） - 在
launch.json中必须指定"miDebuggerPath"，例如 MinGW-w64 对应"C:\\tools\\mingw64\\bin\\gdb.exe" - macOS/Linux 若用
lldb，"type"设为"cppdbg"，"MIMode"设为"lldb"，且"miDebuggerPath"可留空（自动找），但首次调试建议显式写"/usr/bin/lldb"或"/opt/homebrew/bin/lldb" - 检查生成的可执行文件名是否与
"program"字段一致；VSCode 默认生成a.out，但tasks.json若写了"args": ["-o", "hello"]，则launch.json的"program"就得是"./hello"
最常卡住的地方不是哪一步不会做，而是三个 JSON 文件之间路径不一致、架构标识不匹配、或者终端里能跑通但 VSCode 内置终端没继承系统 PATH——建议每次改完配置后，在 VSCode 集成终端里手动运行 g++ --version 和 gdb --version 验证。
