VSCode需手动配置C++工具链：确保g++/gdb在PATH中并版本有效，安装C++扩展但禁用code-runner等冲突插件，通过tasks.json定义编译任务，launch.json配置调试路径与调试器，修改配置后须重启VSCode终端。
VSCode 本身不自带 C++ 编译器或调试器，必须手动配置工具链和调试启动项；直接点击运行会报错 g++: command not found 或调试时卡在 “launching” 状态，本质是路径、扩展、tasks.json 和 launch.json 四者没对齐。
确认系统已安装可用的编译器与调试器
Windows 用户不能只装 MinGW-w64，必须确保 g++.exe 和 gdb.exe 在系统 PATH 中可调用（例如安装 winlibs 并勾选“add to PATH”）；macOS 用户用 brew install gcc 后，g++ 默认指向 clang++，需显式用 g++-13（版本号依实际而定）；Linux 用户检查 which g++ 和 which gdb 是否有输出。
- 在 VSCode 终端里执行
g++ --version和gdb --version，必须返回有效版本号 - Windows 上若用 MSVC，需先运行
vcvarsall.bat配置环境，VSCode 终端默认不继承该环境，建议优先用 MinGW-w64 或 Clang - Clang 用户注意：
clang++编译时需加-g且推荐配--std=c++17，否则调试时可能缺失符号信息
安装必要扩展并禁用冲突插件
C++ 官方扩展（Microsoft 发布，ID ms-vscode.cpptools）必须启用，它提供智能提示、跳转和基础构建支持；但它的内置构建功能不可靠，实际编译要靠 tasks.json 驱动，所以别依赖右键“Run Code”或扩展面板里的“Build”。同时禁用以下插件避免覆盖终端行为或干扰调试：
-
code-runner（它会绕过tasks.json直接调g++，路径错误时静默失败） -
c/c++ compile run（同上，且调试配置与launch.json冲突） - 任何自称“一键编译”的轻量插件——它们无法处理多文件、头文件路径或自定义 flags
手写 tasks.json 控制编译行为
VSCode 的任务系统才是真正接管编译的入口。按 Ctrl+Shift+P → 输入 “Tasks: Configure Task” → 选 “Create tasks.json file from template” → 选 “Others”。替换内容为：
立即学习“C++免费学习笔记（深入）”；
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}",
"-std=c++17",
"-I./include"
],
"group": "build",
"problemMatcher": ["$gcc"],
"detail": "compiler: g++"
}
]
}
关键点：
-
"args"里"-I./include"是可选的，但若项目有本地头文件，必须显式加，否则#include "xxx.h"报错 - Windows 用户把
"command": "g++"改成完整路径如"C:\\mingw64\\bin\\g++.exe"更稳妥，避免 PATH 查找失败 - 如果用 CMake，就别写这个
tasks.json，改用 CMake Tools 扩展 +CMakeLists.txt，两者不可混用
配置 launch.json 实现断点调试
调试前必须确保已成功编译出可执行文件（即 tasks.json 运行无报错）。按 Ctrl+Shift+P → “Debug: Open launch.json” → 选 “C++ (GDB/LLDB)” → “g++ build and debug active file”。生成的模板里重点改三项：
-
"program"必须指向刚生成的可执行文件路径，如"${fileDirname}/${fileBasenameNoExtension}" -
"miDebuggerPath"在 Windows 上填"C:\\mingw64\\bin\\gdb.exe"，macOS 填/opt/homebrew/bin/gdb（Apple 不允许系统 gdb，需用 brew 安装并签名） -
"env"可加环境变量，比如调试 OpenGL 程序时加"LD_LIBRARY_PATH": "/usr/local/lib"（Linux）
常见失败现象：Unable to start debugging. Exception: Unable to resolve non-existing program —— 就是 "program" 路径和实际输出路径不一致；或者 Cannot find GDB —— "miDebuggerPath" 指向了不存在的文件。
最易被忽略的是：每次修改 tasks.json 或 launch.json 后，必须关闭再重开 VSCode 终端（或重启窗口），因为这些配置不会热重载；还有，调试时务必在 main() 入口前设断点，否则程序一闪而过——这不是配置问题，是习惯问题。
