VSCode调试C++需三步：装对编译器与调试器并加入PATH；tasks.json正确配置command、args（含-g）、group；launch.json严格匹配program路径、MIMode和miDebuggerPath。
VSCode 本身不带 C++ 编译器和调试器，必须手动配置外部工具链；直接点开 main.cpp 按 F5 肯定失败，核心在于三件事：装对编译器、写对 tasks.json、配准 launch.json 中的调试器路径。
确认系统已安装可用的 C++ 工具链
Windows 上最省事的是装 MinGW-w64（推荐 MSYS2 安装）或 Visual Studio Build Tools；macOS 必须先装 Xcode Command Line Tools（运行 xcode-select --install）；Linux 用户确保 g++ 和 gdb 已通过包管理器安装（如 Ubuntu 执行 sudo apt install build-essential gdb）。
验证是否就绪：
- 终端中运行
g++ --version或clang++ --version，有输出即编译器可用 - 运行
gdb --version（Linux/macOS）或gdb.exe --version（MinGW），确认调试器存在 - 把编译器/调试器所在目录加进系统
PATH，否则 VSCode 的终端和任务都找不到它们
用 tasks.json 定义编译任务
tasks.json 控制「怎么编译」，不是写个命令就行，关键要匹配你的工具链和项目结构。常见错误是照抄网上模板却没改 args 里的标准版本或输出路径。
立即学习“C++免费学习笔记（深入）”；
生成方式：打开命令面板（Ctrl+Shift+P），输入 Tasks: Configure Default Build Task → 选 C/C++: g++.exe build active file（Windows）或 C/C++: g++ build active file（其他平台），VSCode 会自动生成基础 tasks.json。
需手动检查的要点：
-
command必须指向你实际安装的编译器，例如"command": "g++"或"command": "C:\\msys64\\ucrt64\\bin\\g++.exe" -
args中至少包含"-g"（生成调试信息）、"-std=c++17"（按需调整标准）、"-o"后跟可执行文件名（如"${fileDirname}\\${fileBasenameNoExtension}.exe"） -
group设为"build"，才能让Ctrl+Shift+B触发该任务
用 launch.json 配置调试器参数
launch.json 决定「怎么启动调试」，最容易出问题的是 program 路径没和 tasks.json 输出路径对齐，或 MIMode 填错。
生成方式：按 F5 → 选 C++ (GDB/LLDB) → 选环境（GDB 对应 MinGW/g++，LLDB 对应 Clang/macOS）→ VSCode 自动生成模板。
必须核对的字段：
-
program：值必须与tasks.json中-o指定的输出路径完全一致，例如"${fileDirname}\\${fileBasenameNoExtension}.exe" -
MIMode：Windows + MinGW 填"gdb"；macOS/Linux 填"gdb"或"lldb"（取决于你装的是哪个） -
miDebuggerPath：显式指定调试器绝对路径，比如"C:\\msys64\\ucrt64\\bin\\gdb.exe"，不填可能找不到 -
preLaunchTask：值必须与tasks.json中label字段一致（默认是"C/C++: g++.exe build active file"）
为什么改了配置还是调试失败？
90% 的失败不是配置写错，而是路径不一致或权限/空格问题：
- Windows 下路径含中文或空格（如
C:\Users\张三\project）会导致gdb启动失败，建议项目放纯英文无空格路径 -
tasks.json和launch.json的cwd（工作目录）最好都设为"${fileDirname}"，避免相对路径解析错位 - 修改任一 JSON 后，必须保存文件再试；VSCode 不会热重载这些配置
- 如果提示
The selected debug configuration 'cppdbg' is missing a required property，说明launch.json缺字段，重新生成一次更省事
真正麻烦的永远不是多写几行 JSON，而是编译器、调试器、VSCode 三者对同一路径的理解不一致——盯着 program 和 args 里的 -o 多看两遍，比查教程快得多。
