VSCode C++开发需手动配置工具链和JSON文件：先安装g++/clang++与GDB/LLDB并加入PATH，再生成修正tasks.json（含-g、-std）和launch.json（核对program、miDebuggerPath、externalConsole），最后通过C/C++扩展配置c_cpp_properties.json以支持智能提示。
VSCode 本身不内置 C++ 编译器或调试器，必须手动配置外部工具链和调试适配器；直接点击“运行”按钮必然失败，核心在于正确生成 tasks.json 和 launch.json 并确保 g++ 或 clang++ 在系统 PATH 中可访问。
确认并安装基础工具链（Windows/macOS/Linux 通用）
VSCode 的 C++ 支持完全依赖你本地已安装的编译器和 GDB/LLDB。没装好这些，后续所有 JSON 配置都是空转。
- Windows：安装
MinGW-w64（推荐 官方构建版）或Visual Studio Build Tools（含cl.exe），并把bin/目录加进系统 PATH；验证运行g++ --version或cl - macOS：用
brew install llvm装clang++和lldb，或 Xcode 命令行工具（xcode-select --install） - Linux：通常自带
g++和gdb，若无则sudo apt install build-essential gdb（Ubuntu/Debian）
生成 tasks.json：让 Ctrl+Shift+B 能真正编译
tasks.json 定义“构建任务”，它不自动创建，必须通过 VSCode 命令触发生成，且需手动修正编译器路径、标准和输出位置——否则默认模板常指向不存在的 g++ 或忽略 -std=c++17 等关键参数。
- 在打开的 C++ 文件中按
Ctrl+Shift+P→ 输入 “Tasks: Configure Default Build Task” → 选 “C/C++: g++.exe build active file”（Windows）或 “C/C++: clang++ build active file”（macOS/Linux） - 打开生成的
.vscode/tasks.json，检查args数组：确保包含"-g"（生成调试信息）、"-std=c++17"（按需调整）、"-o"输出到"${fileDirname}/${fileBasenameNoExtension}" - 若用 MSVC（
cl.exe），需替换整个command为"cl.exe"，并用/Zi /EHsc /Fe:替代 GCC 参数；此时args里不能有单连字符（如-o）
配置 launch.json：F5 启动调试前必须填对的三项
launch.json 控制调试器行为，最常见失败原因是 program 路径错误、miDebuggerPath 指向不存在的 GDB、或 externalConsole 在 Windows 上设为 false 导致输入卡死。
立即学习“C++免费学习笔记（深入）”；
- 按
Ctrl+Shift+P→ “Debug: Open launch.json” → 选 “C++ (GDB/LLDB)” → “g++.exe” 或 “clang++” - 关键字段必须手动核对：
-
"program"：值应为编译后可执行文件的绝对路径，例如"${fileDirname}/${fileBasenameNoExtension}"（注意：没有 .exe 后缀，Windows 下 VSCode 会自动补） -
"miDebuggerPath"：Windows MinGW 用户填"C:\mingw64\bin\gdb.exe"（路径用双反斜杠），macOS 填"/opt/homebrew/bin/lldb"或"lldb"（若已加入 PATH） -
"externalConsole"：Windows 下建议设为true，否则控制台输入会被阻塞；Linux/macOS 可设false使用集成终端
-
- 调试时若报错 “Unable to start debugging”，优先检查
program文件是否存在、是否被杀毒软件锁定、以及gdb是否能从命令行直接运行
C++ 扩展与 c_cpp_properties.json 的隐性影响
微软官方 C/C++ 扩展（ms-vscode.cpptools）不是可选插件，它提供智能提示、跳转和头文件索引，而 c_cpp_properties.json 决定这些功能能否识别你的标准库路径和宏定义——写 #include <vector> 报红？大概率是这里没配好。
- 按
Ctrl+Shift+P→ “C/C++: Edit Configurations (UI)” 自动生成该文件 - 重点检查
"browse.path"：Windows MinGW 应包含"C:/mingw64/x86_64-w64-mingw32/include/c++"等路径；macOS Clang 则需"/opt/homebrew/opt/llvm/include/c++/v1" -
"defines"可添加项目级宏（如"DEBUG"），避免每次编译手动传-DDEBUG - 修改后务必重启 VSCode 窗口，否则 IntelliSense 不刷新
真正卡住人的往往不是 JSON 语法，而是编译器路径拼写错误、GDB 版本太老不支持新 ABI、或者 Windows 杀软静默拦截了 gdb.exe 的调试权限——建议先在终端里手动跑通 g++ -g hello.cpp -o hello && gdb ./hello，再回到 VSCode。
