必须先验证g++ --version在终端中能正常输出版本号，再安装C/C++插件；否则F5调试会因“找不到编译器”失败。Windows需将MinGW-w64的bin路径（如C:mingw64in）加入PATH，且路径不能含中文、空格或括号。
VSCode里装C/C++插件前必须确认g++能用
插件装得再快也没用，g++ --version 在终端里跑不通，后续所有调试都会卡在“找不到编译器”或“launch.json 配置无效”。Windows 用户尤其要注意：MinGW-w64（比如 MSYS2 的 ucrt64）或 nuwen.net 的 MinGW Distro 安装后，bin 路径必须加进系统 Path 环境变量，且路径中不能含中文、空格或括号（如 C:Program Files... 就容易出问题）。
验证方式很简单：
- 打开 VSCode 集成终端（
Ctrl+`），输入g++ --version - 若提示“不是内部或外部命令”，说明环境变量没生效，别急着装插件
- 若返回类似
g++ (Rev5, Built by MSYS2 project) 14.2.0，才算过关
安装C/C++插件时只认Microsoft官方那个
在扩展市场搜 C/C++，顶部第一个带“Microsoft”标识、作者名是 ms-vscode.cpptools 的才是正主。其他名字相近的（比如 “C++ Intellisense”、“C/C++ Snippets”）都是辅助工具，不能替代它。
这个插件负责：c_cpp_properties.json 解析、头文件路径索引、断点映射、GDB/LLDB 启动封装——少了它，F5 调试根本不会弹出配置选项。
注意两个细节：
- 安装完会提示“重新加载窗口”，必须点，否则插件不激活
- 首次打开 C++ 文件（如
main.cpp）时，右下角可能弹出“检测到 C++ 项目，是否配置 IntelliSense？”，点“是”，它会自动生成基础c_cpp_properties.json
第一次按F5调试时选错环境就全白搭
按 F5 后弹出的环境选择菜单里，必须选 C++ (GDB/LLDB) 或 C++ (Windows)（取决于你装的是 MinGW 还是 MSVC）。如果误选了 Node.js、Python 或空模板，VSCode 会生成错误的 launch.json，后续改起来反而更麻烦。
正确流程是：
- 确保当前打开的是一个
.cpp文件（不是纯文件夹） - 按
F5→ 选C++ (GDB/LLDB)→ 再选g++.exe（Windows）或g++（macOS/Linux） - 它会自动创建
.vscode/launch.json，其中关键字段是："program": "${fileDirname}\${fileBasenameNoExtension}.exe"（Windows）或"program": "${fileDirname}/${fileBasenameNoExtension}"（其他系统） - 这个
program路径必须和tasks.json编译输出的目标一致，否则调试启动时报“找不到可执行文件”
tasks.json里不写"args"参数，带命令行参数的程序就调不了
默认生成的 tasks.json 只负责编译，不传参。但如果你的 main(int argc, char* argv[]) 依赖命令行参数（比如 ./a.out input.txt），就必须手动加 "args" 字段。
示例片段（Windows）：
{
"args": [
"input.txt"
]
}
这个 args 是给最终运行的可执行文件用的，不是给 g++ 编译器用的。漏掉它，断点进了 main，但 argc 永远是 1。
另外注意：tasks.json 中的 "group": "build" 和 "presentation": { "echo": true } 建议保留，否则编译失败时终端不报错，只静默退出。
真正卡住人的地方往往不在插件安装步骤本身，而在 g++ 路径、launch.json 的 program 字段、以及 tasks.json 是否真能生成对应名字的可执行文件——三者必须严丝合缝，差一个斜杠或大小写都可能让调试直接失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
