VSCode需手动配置系统C++编译器及tasks.json、c_cpp_properties.json、launch.json三文件才能正常编译调试；Windows推荐MinGW-w64，macOS装Xcode命令行工具，Linux装build-essential或gcc-c++；验证g++/clang++可用后，再配置扩展与任务。
VSCode 本身不带 C++ 编译器，必须手动配置外部工具链和任务，否则点击运行只会报错 g++: command not found 或卡在“正在生成任务”。
确认系统已安装可用的 C++ 编译器
VSCode 只是编辑器，真正编译靠的是你系统里的 g++（Linux/macOS）或 cl.exe（Windows + Visual Studio）或 g++.exe（MinGW）。没装好这个，后续所有配置都是空谈。
- Windows 用户：推荐安装 MinGW-w64，并把
bin/目录加进系统PATH；验证方式：终端执行g++ --version能输出版本号 - macOS 用户：装 Xcode Command Line Tools（
xcode-select --install），它自带clang++；也可用 Homebrew 装gcc，但默认仍走clang++ - Linux 用户：多数发行版需手动装
build-essential（Ubuntu/Debian）或gcc-c++（CentOS/RHEL）
安装 C/C++ 扩展并配置 c_cpp_properties.json
微软官方的 C/C++ 扩展（ms-vscode.cpptools）提供智能提示、跳转和调试支持，但它不负责编译——它只依赖你告诉它“头文件在哪、用哪个编译器、宏怎么定义”。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入C/C++: Edit Configurations (UI)，填入compilerPath，例如：/usr/bin/g++或C:/mingw64/bin/g++.exe - 确保
intelliSenseMode和你的编译器匹配：用g++就选gcc-x64，用clang++就选clang-x64 - 如果项目含第三方库（如 OpenCV），在
includePath中显式添加路径，否则#include红波浪线不会消失
用 tasks.json 定义编译任务
VSCode 的“运行”（Ctrl+Shift+B）本质是调用 tasks.json 里定义的 shell 命令。不配这个，就只能切到终端手动敲 g++ main.cpp -o main。
立即学习“C++免费学习笔记（深入）”；
- 通过
Terminal > Configure Default Build Task > Create tasks.json file from template > Others创建空模板 - 填入实际编译命令，关键字段示例：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "/usr/bin/g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"group": "build",
"problemMatcher": ["$gcc"]
}
]
}
-
problemMatcher必须设为$gcc（或$clang），否则编译错误不会在“问题”面板中高亮显示 - Windows 上路径分隔符用正斜杠
/更稳妥；${file}是当前打开的文件路径，不是整个文件夹
用 launch.json 启动调试而非仅运行
按 F5 调试前，必须有 .vscode/launch.json，且 program 字段要指向已编译好的可执行文件（不能是 .cpp 源码）。很多新手卡在这一步，以为“运行”和“调试”是同一套流程。
- 首次调试时 VSCode 会引导生成
launch.json，选择环境为GDB/LLDB（Linux/macOS）或Windows (GDB)（MinGW） -
program值应为"${fileDirname}/${fileBasenameNoExtension}"，与tasks.json输出路径一致 - 务必开启
preLaunchTask，值设为g++ build active file（即tasks.json中的label），否则调试时可能运行旧二进制 - 若调试时提示
Cannot find GDB，说明没装gdb（Windows MinGW 自带，Linux/macOS 需单独装）
最常被忽略的一点：每次换编译器（比如从 g++ 切到 clang++）、换架构（x64 → arm64）、或加了新库，都得同步更新 c_cpp_properties.json 和 tasks.json 里的路径与参数——VSCode 不会自动感知这些变化。
