compilerPath必须填g++.exe（Windows）或g++（macOS/Linux），不能填gcc，否则VSCode的C/C++扩展会误判为C语言环境，导致<string>等C++头文件无法识别、std::补全失效；因扩展依赖该路径推导标准库路径与intelliSenseMode。
VSCode 里 c_cpp_properties.json 中的 compilerPath 必须指向 g++.exe（Windows）或 g++（macOS/Linux），而不是 gcc；否则 C++ 标准库头文件（如 string、vector）无法被 IntelliSense 正确解析，补全和跳转会频繁报错。
为什么 compilerPath 不能填 gcc？
VSCode 的 C/C++ 扩展通过 compilerPath 推导标准库路径与语言模式（intelliSenseMode）。填 gcc 会触发 C 模式推断，即使你打开的是 .cpp 文件，它也默认加载 C 标准头（stdio.h 等），而忽略 bits/ 下的 C++ 实现细节。结果就是：#include <string> 显示 “cannot open source file”，std:: 补全失效。
实操建议：
- 在 VSCode 命令面板（
Ctrl+Shift+P）中运行C/C++: Edit Configurations (UI) - 点
Compiler path右侧放大镜图标 —— 它只扫描PATH中的g++.exe或g++，自动填入并同步设置intelliSenseMode为clang-x64或gcc-x64 - 手动编辑时，确认路径末尾是
g++.exe（Windows）或g++（macOS/Linux），例如："compilerPath": "D:\mingw64\bin\g++.exe"
tasks.json 编译命令必须带 -g 且输出路径明确
没有 -g，launch.json 就无法读取调试符号，F5 启动后直接报 “Unable to start debugging” 或断点灰掉；不指定 -o 输出路径，VSCode 不知道该加载哪个可执行文件，program 字段会找不到目标。
立即学习“C++免费学习笔记（深入）”；
常见错误现象：
- 按
F5后弹窗提示 “The preLaunchTask 'build' terminated with exit code 1” - 终端显示
g++.exe: error: unrecognized command-line option '-g'（说明你误用了旧版 MinGW 或路径指向了gcc）
实操建议：
- 用
Ctrl+Shift+P→Tasks: Configure Default Build Task→ 选g++.exe build active file自动生成tasks.json - 检查生成的
args数组是否包含："-g"、"-O0"（禁用优化，避免调试时变量被优化掉）、"-std=c++17"（或更高）、"-o"后跟明确路径，例如："${fileDirname}\${fileBasenameNoExtension}.exe" - Windows 用户注意反斜杠转义：路径中写
\，不是，否则 JSON 解析失败
launch.json 的 miDebuggerPath 和 preLaunchTask 必须严格匹配
miDebuggerPath 指向的 gdb.exe（Windows）或 gdb（Linux）必须和 tasks.json 中使用的编译器来自同一工具链。混用 MinGW-gdb + Clang 编译产物，或 macOS 上用 lldb 却在 launch.json 里写 "MIMode": "gdb"，都会导致调试器启动失败。
实操建议：
- 确认
gdb --version能在 VSCode 集成终端中执行成功（重启 VSCode 后再试，确保 PATH 生效） -
launch.json中"preLaunchTask"的值（如"task g++"）必须和tasks.json顶层label字段完全一致（区分大小写） - Windows MinGW 用户：
"miDebuggerPath"填绝对路径，例如："D:\mingw64\bin\gdb.exe"；不要用which gdb或环境变量缩写 - macOS 用户：
"MIMode"必须设为"lldb"，且"miDebuggerPath"可留空（扩展会自动查找），但若装了 Homebrew GCC，则需填/opt/homebrew/bin/gdb并确保已 codesign
最容易被忽略的点是：所有配置文件（c_cpp_properties.json、tasks.json、launch.json）里的路径、标准、输出名三者必须完全一致；任意一个环节用 gcc 替代 g++，或漏掉 -g，或 preLaunchTask 名字拼错一个字母，整个调试链就断了 —— 它不会报具体哪错了，只会静默失败。
