VSCode 需手动配置外部工具链才能支持 C++ 开发。Windows 推荐 MinGW-w64 并加 PATH；macOS 安装 Xcode 命令行工具和 brew install cmake gdb；Linux 用 apt 安装 build-essential、gdb、cmake。
VSCode 本身不是 IDE，不自带 C++ 编译器和调试器，所谓“配置环境”本质是把 g++（或 clang++）、cmake、gdb（或 lldb）这些外部工具链接进来，并让 VSCode 知道怎么调用它们。没装对工具链，装再多插件也没用。
确认系统已安装可用的 C++ 工具链
这是最常卡住的一步。Windows 用户别只装 VSCode 就以为完事了——VSCode 插件 C/C++ 不提供编译器，它只负责语法提示和跳转。
- Windows：推荐直接安装 MinGW-w64（x86_64-14.2.0-release-posix-seh），安装时勾选
add to PATH；装完后终端运行g++ --version和gdb --version必须有输出 -
macOS：运行
xcode-select --install装命令行工具，再用brew install cmake gdb（注意：macOS 自带的lldb可直接用，但gdb需要手动签名） - Linux（Ubuntu/Debian）：运行
sudo apt update && sudo apt install build-essential gdb cmake
VSCode 必装插件与关键配置项
插件装错或配置路径写死，会导致 launch.json 或 c_cpp_properties.json 一直报“无法找到 IntelliSense 配置”。
- 必须安装：
C/C++（Microsoft 官方，IDms-vscode.cpptools），它提供头文件索引、#include补全、F12跳转 - 可选但强烈建议：
CMake Tools（配合CMake项目），CodeLLDB（macOS/Linux 下比gdb更省心） - 关键配置：打开命令面板（
Ctrl+Shift+P），输入C/C++: Edit Configurations (UI)，在Compiler path里填绝对路径，例如 Windows 上是C:\mingw64\bin\g++.exe，不能写g++—— 否则 IntelliSense 找不到标准库路径
跑通一个最简 main.cpp 的三步操作
别一上来就搞多文件、CMakeLists.txt。先验证编辑、编译、调试闭环是否成立。
立即学习“C++免费学习笔记（深入）”；
- 新建文件夹，用 VSCode 打开，新建
main.cpp，写上int main() { return 0; } - 按
Ctrl+Shift+B触发构建：如果提示“未配置生成任务”，选g++.exe build active file（会自动生成.vscode/tasks.json）；构建成功后生成a.exe（Windows）或a.out（macOS/Linux） - 按
F5启动调试：若提示“请创建 launch.json”，选C++ (GDB/LLDB)→g++.exe - Build and debug active file；确保program字段指向正确可执行路径，如"./a.exe"
tasks.json 和 launch.json 常见失效原因
这两个文件不是“设一次就永久生效”的配置，它们高度依赖当前工作区路径、编译器路径、输出目录是否一致。
-
tasks.json中args列表里漏掉-g：会导致launch.json启动调试时提示 “No debugging symbols found” -
launch.json中miDebuggerPath写成gdb而非完整路径（如C:\\mingw64\\bin\\gdb.exe）：Windows 下必失败，因为 VSCode 的调试器进程不继承系统 PATH - 项目根目录下有多个
.cpp文件，但tasks.json仍用${file}：此时按Ctrl+Shift+B只编译当前打开的文件，其他文件的改动不会被链接进去——该换用cmake或手写 makefile
真正麻烦的从来不是 VSCode 设置本身，而是不同系统下工具链版本差异、PATH 污染、权限限制（比如 macOS 上 gdb 要 codesign）、甚至中文路径导致 g++ 报 fatal error: no input files。先跑通单文件，再谈工程化。
