能跑通g++ --version和gdb --version且路径不含中文、空格，是vs code调试c/c++的硬门槛；必须将mingw-w64的bin目录加入path、重启vs code，并在tasks.json中加-g、launch.json中指定midebuggerpath指向gdb.exe。
能跑通 g++ --version 和 gdb --version，且路径不含中文、空格，是 VS Code 能调试 C/C++ 的硬门槛；其余配置失败，90% 是卡在这一步。
MinGW-w64 安装路径和环境变量必须干净
Windows 上最常出问题的不是插件或 JSON 配置，而是 MinGW 的安装路径里带了中文、空格或符号（比如 C:Program Filesmingw64 或 D:我的C++项目mingw64）。这类路径会导致 g++ 找不到头文件、gdb 启动失败、VS Code 提示“无法启动调试会话”。
- 解压或安装时直接选根目录，例如
C:mingw64或D:mingw64 - 把
C:mingw64in（注意是bin子目录）加进系统环境变量PATH，不是C:mingw64本身 - 改完环境变量后，**必须重启 VS Code**（只关窗口不行，要彻底退出进程）
- 验证方式：新开一个终端（CMD/PowerShell），执行
g++ --version和gdb --version，两行都输出版本号才算过关
tasks.json 编译任务必须含 -g 且用 g++.exe
VS Code 默认不生成调试信息，launch.json 依赖 tasks.json 输出带符号表的可执行文件。如果编译时不加 -g，断点会显示为“未绑定”，单步执行直接跳过。
- 按
Ctrl+Shift+P→ 输入Tasks: Configure Default Build Task→ 选g++.exe build active file - 检查生成的
.vscode/tasks.json中args是否包含："-g"、"-std=c++17"（或更高）、"-O0"（调试时关闭优化） - 确保
command是"g++.exe"，不是"gcc.exe"（后者编译 C++ 文件可能链接失败） - 如果手动写
args，最后一项必须是"-o", "${fileDirname}\${fileBasenameNoExtension}.exe"，否则生成的 exe 不在当前目录，launch.json找不到
launch.json 的 miDebuggerPath 必须指向真实 gdb.exe
VS Code 自动创建的 launch.json 常把 miDebuggerPath 设为空或默认值，导致点击 F5 时弹出“无法找到 GDB”或“gdb 进程已退出”。它不会自动猜你装在哪。
- 打开
.vscode/launch.json，定位到configurations下的miDebuggerPath字段 - 填入完整绝对路径，例如：
"C:\mingw64\bin\gdb.exe"（注意双反斜杠） - 同时确认
program字段指向的是 tasks 编译出的 exe，如"${fileDirname}\${fileBasenameNoExtension}.exe" - 如果用了 Code Runner 插件，它的运行和调试是分离的——它不走
launch.json，所以调试仍需 F5 + 正确的launch.json
C/C++ 扩展的 c_cpp_properties.json 要匹配 MinGW 头文件路径
没配好这个文件，编辑器里会满屏红色波浪线，#include <vector></vector> 报错“无法打开源文件”，但代码实际能编译通过。这是 IntelliSense 路径和编译器路径不一致造成的假错误。
- 按
Ctrl+Shift+P→ 输入C/C++: Edit Configurations (UI)，打开图形化配置页 - 在 “Compiler path” 中填：
C:mingw64ing++.exe - 保存后，VS Code 会自动生成
includePath，通常包含"C:/mingw64/x86_64-w64-mingw32/include/**"等路径 - 如果仍有报错，手动检查生成的
.vscode/c_cpp_properties.json里includePath是否覆盖了C:mingw64libgcc***includec++和C:mingw64_64-w64-mingw32include
真正卡住人的从来不是 JSON 文件怎么写，而是 g++.exe 和 gdb.exe 能不能被系统和 VS Code 同时“看见”。路径、环境变量、重启，这三件事漏掉任何一个，后面所有配置都是白忙。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
