能跑通g++ --version和gdb --version且mingw-w64解压路径全英文、无空格、含bin子目录，是vscode运行c++代码不出错的硬门槛；其余90%配置问题均源于此。
能跑通 g++ --version 和 gdb --version，且 MinGW-w64 解压路径全英文、无空格、含 bin 子目录，是 VSCode 跑 C++ 代码不出错的硬门槛。其余配置问题，90% 都卡在这一步。
MinGW-w64 安装路径和环境变量为什么总出问题
Windows 下最常报错的根源不是插件或 JSON 文件写错了，而是 MinGW 被解压到了带中文、空格或符号的路径里，比如 C:Program Filesmingw64 或 D:我的C++项目mingw64。这类路径会导致 g++ 找不到头文件、gdb 启动失败、VSCode 提示“无法启动调试会话”或“找不到编译器”。
- 解压时直接选根目录，例如
C:mingw64或D:mingw64 - 必须把
C:mingw64in（注意是bin子目录）加进系统环境变量PATH，不是C:mingw64本身 - 改完环境变量后，必须彻底退出 VSCode 进程（右键任务栏图标 → “退出”，不能只关窗口），再重新打开
- 验证方式：新开一个 CMD 窗口，运行
g++ --version和gdb --version，两行都输出版本号才算过关；再运行where g++，确认路径指向你刚装的mingw64ing++.exe
tasks.json 编译任务必须带 -g 且用 g++.exe
VSCode 默认不生成调试符号，如果 tasks.json 里没加 -g，launch.json 就没法设断点——你会看到断点显示为“未绑定”，F5 后直接运行完，单步执行也跳过。
- 按
Ctrl+Shift+P→ 输入Tasks: Configure Default Build Task→ 选g++.exe build active file - 检查生成的
.vscode/tasks.json中args是否包含："-g"、"-O0"（关闭优化）、"-std=c++17"（或更高） -
command字段必须是"g++.exe"，不是"gcc.exe"（后者编译.cpp文件可能链接失败） -
args最后一项必须是"-o"后跟输出路径，例如"${fileDirname}\${fileBasenameNoExtension}.exe"，否则生成的可执行文件不在当前目录，launch.json找不到
launch.json 的 miDebuggerPath 必须填绝对路径
VSCode 自动创建的 launch.json 常把 miDebuggerPath 设为空或默认值，导致点击 F5 时弹出“无法找到 GDB”或“gdb 进程已退出”。它不会自动猜你装在哪。
- 打开
.vscode/launch.json，定位到configurations下的miDebuggerPath字段 - 填入完整绝对路径，例如：
"C:\mingw64\bin\gdb.exe"（注意双反斜杠） - 同时确认
program字段指向的是tasks.json编译出的.exe，如"${fileDirname}\${fileBasenameNoExtension}.exe"，Windows 下必须显式写.exe后缀 - 如果用了 Code Runner 插件，它的“运行”不走
launch.json，所以调试仍需 F5 + 正确的launch.json
c_cpp_properties.json 的 compilerPath 和 intelliSenseMode 必须匹配
这个文件不光影响代码补全，还决定头文件解析路径和宏定义行为。选错会导致 #include <iostream></iostream> 报红、std::vector 无法跳转、甚至 std::optional 不识别。
-
compilerPath必须写绝对路径，例如："C:\mingw64\bin\g++.exe"，不能写"g++"—— IntelliSense 不走 shellPATH查找 -
intelliSenseMode要按 MinGW-w64 架构选：gcc-x64（64 位）、gcc-x86（32 位），别硬套clang-x64 - 如果项目用 C++17 特性，记得同步设置
"cppStandard": "c++17"，否则补全可能漏符号 - 修改后保存，VSCode 会自动重载 IntelliSense，观察右下角语言模式是否显示“C++”并稳定，否则说明配置未生效
真正容易被忽略的点是：MinGW 的 bin 目录不仅要进系统 PATH，还要确保 VSCode 启动时能读到它——这要求你彻底退出 VSCode 进程，而不是仅关闭窗口；另外，tasks.json 和 launch.json 之间靠文件名和路径严格耦合，一个 .exe 后缀漏写、一个反斜杠写成正斜杠、一个大小写不一致，都会让整个调试链断裂。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
