VSCode 需手动配置 C++ 工具链与调试环境：先安装匹配的编译器（如 MinGW-w64/g++/clang++）并加入 PATH；再配置 c_cpp_properties.json、tasks.json（含 -g）、launch.json（指定 program 和 miDebuggerPath）；确保编译器、GDB、扩展 ABI 兼容。
VSCode 本身不是 IDE，没有内置 C++ 编译器或调试器，必须手动配置工具链和调试适配层。直接安装插件不等于能跑起来，关键在 tasks.json、launch.json 和系统 PATH 的协同。
确认本地已安装可用的 C++ 工具链
VSCode 不提供编译能力，它只调用外部工具。Windows 上常见组合是 MinGW-w64（推荐 x86_64-11.2.0-release-win32-seh-rt_v9-rev1）或 Microsoft Visual Studio Build Tools；macOS 用 clang++（Xcode Command Line Tools 自带）；Linux 用 g++（sudo apt install build-essential）。
- 终端执行
g++ --version或clang++ --version必须返回有效版本号 - 确保对应编译器路径已加入系统
PATH（Windows 注意不要混用 PowerShell 和 CMD 的环境变量） - MinGW 用户需避免安装含空格的路径（如
C:Program Files...），否则launch.json中的miDebuggerPath易失效
安装并配置 C/C++ 扩展（ms-vscode.cpptools）
这是微软官方扩展，提供智能提示、跳转、格式化等核心功能，但不包含构建和调试逻辑——它只是“桥梁”。安装后必须手动配置 c_cpp_properties.json，否则头文件无法识别、#include 报红。
- 按
Ctrl+Shift+P→ 输入C/C++: Edit Configurations (UI)可图形化生成c_cpp_properties.json - 重点检查
"compilerPath"是否指向你实际安装的g++或clang++可执行文件（例如"C:\mingw64\bin\g++.exe"） -
"intelliSenseMode"需与编译器匹配：GCC 对应gcc-x64，Clang 对应clang-x64，错配会导致宏定义丢失、STL 提示异常
用 tasks.json 定义编译任务
tasks.json 控制 VSCode 如何调用编译器，它决定你按 Ctrl+Shift+B 后发生什么。默认模板往往不适用，尤其对多文件项目或需要链接库的场景。
立即学习“C++免费学习笔记（深入）”；
- 选择
Others模板而非G++，避免被预设参数干扰 -
"args"中必须显式包含-g（生成调试信息），否则launch.json无法断点 - 单文件简单项目可写：
["-g", "-o", "${fileDirname}/${fileBasenameNoExtension}.out", "${file}"] - 若使用 CMake，不要手写
tasks.json，改用 CMake Tools 扩展 +cmake.buildDirectory配置
用 launch.json 配置调试器行为
launch.json 告诉 VSCode 如何启动调试会话。最关键的不是“能不能运行”，而是“能否正确 attach 到进程并读取符号”。Windows 下 MinGW 用户最容易卡在这里。
-
"program"必须指向tasks.json中生成的可执行文件（注意后缀，MinGW 默认是.exe，Linux/macOS 无后缀） - MinGW 用户必须设置
"miDebuggerPath"，值为gdb.exe绝对路径（如"C:\mingw64\bin\gdb.exe"），不能只写gdb -
"externalConsole"设为true才能在独立窗口看到cin输入；设为false时输入需在 VSCode 内置终端中完成，且可能卡住 - 如果断点显示为空心圆（未加载符号），优先检查
tasks.json是否漏了-g，再查launch.json中"program"路径是否拼写错误
真正卡住人的往往不是某一个配置文件写错，而是编译器、GDB、VSCode 扩展三者 ABI 不兼容——比如用 Clang 编译却用 GDB 调试，或 MinGW 版本太新导致 GDB 无法解析 DWARF5。遇到“断点无效”“变量显示 <optimized out>”，先回到 tasks.json 确认 -O0 -g 是否同时存在，再验证 gdb --version 和编译器是否同源。
