VSCode C++编译运行教程：MinGW安装与tasks.json编译配置

想要在 VS Code 里顺利编译并调试 C++ 程序，最大的前提其实就一句话：g++ --version 和 gdb --version 必须能正常执行，而且 MinGW-w64 的安装路径里不能出现中文、空格或括号。只要这一步卡住，后面再怎么折腾 tasks.json，F5 和 Ctrl+Shift+B 都会静默失败，或者直接报“找不到命令”。

有些读者可能会问，为什么别人照抄配置就能跑起来，自己却死活不行？真相往往就卡在环境变量和路径这两个看似不起眼的地方。

g++ --version 报错？先盯死 PATH 和安装路径

这不是 VS Code 的问题，而是系统压根就没找到编译器。VS Code 只是在启动的那一瞬间读取环境变量，所以修改完 PATH 之后，必须彻底退出 VS Code——最好打开任务管理器确认 Code.exe 进程已经结束——然后再重新打开。

• 验证方式很简单：打开一个全新的 CMD 或 PowerShell，直接输入 g++ --version。必须有正常输出；如果提示“不是内部或外部命令”，说明 PATH 根本就没生效，或者路径填错了。
• MinGW-w64 的解压或安装路径，严禁包含中文、空格和括号。像 C:\Program Files\mingw64 或 D:\我的项目\mingw64 这类路径就是定时冲击波，推荐直接放在 C:\mingw64 或 D:\mingw64。
• PATH 里添加的必须是 C:\mingw64\bin，而不是 C:\mingw64。少一个 \bin，就等于白配。

tasks.json 必须带 -g 且 command 是 g++.exe

VS Code 默认生成的构建任务是不带调试信息的，后果就是断点显示“未绑定”，单步执行直接跳过，跟没断点似的。你写的 tasks.json 不能只是“能编译就行”，必须确保输出的可执行文件里包含符号表。

• command 字段必须是 "g++.exe"（Windows 下），千万别写成 "gcc.exe"——后者链接 C++ 标准库时很容易出错，尤其是你用了 #include 。
• args 数组里必须包含 "-g"（生成调试信息）、"-O0"（关闭优化，否则变量会被优化掉，调试时看不见值）、"-std=c++17" 或更高版本（避免 C++20 特性报错）。
• 最后一项必须是 "-o" 后紧跟输出路径，比如 "${fileDirname}\\${fileBasenameNoExtension}.exe"。漏掉这个，生成的 exe 会跑到一个奇怪的位置，你的 launch.json 找不到它。

Ctrl+Shift+B 没反应？检查 task label 和默认任务绑定

VS Code 的构建快捷键依赖于“默认构建任务”是否正确定义。就算 tasks.json 里写了多个任务，系统也只认那个被设为 default 的。

• 按 Ctrl+Shift+P 打开命令面板，输入 Tasks: Configure Default Build Task，然后选中你刚刚配置的那个 task（比如 label 是 "g++ build active file"）。不要手动去改 isDefault 字段，让 VS Code 帮你管理。
• task 的 label 值尽量简洁，别带空格或特殊字符。有些插件（比如旧版 Code Runner）会按 label 名去触发，混乱的 label 容易导致误匹配。
• 如果还是没反应，打开命令面板并选择 Developer: Toggle Developer Tools，在 Console 标签页看是否有 spawn g++.exe ENOENT 类的错误信息。出现这个，说明 command 路径无效，直接退回上一步去检查 PATH 吧。

Code Runner 运行结果和调试不一致？别混用两套流程

Code Runner 的 Ctrl+Alt+N 是一条完全独立的运行链路，它不受 tasks.json 和 launch.json 控制。它生成的可执行文件不带 -g 调试信息，也不走 GDB，只是快速编译加执行，适合看输出，但不适合调试。

• 想单步执行、设置断点、查看变量值，必须用 Ctrl+Shift+B 加 F5 这套组合，而且必须确保 tasks.json 和 launch.json 全部配对正确。
• 如果你同时启用了 Code Runner，建议在它的设置里关掉 C++ 的自动保存编译（将 code-runner.sa veFileBeforeRun 设为 false）。否则它会偷偷覆盖你刚刚用 Ctrl+Shift+B 编译好的那个带调试信息的 exe 文件。
• 最稳妥的做法：快速验证输出时用 Code Runner；真正调试前，先手动按一次 Ctrl+Shift+B 完成构建，再按 F5 启动调试。

说白了，真正卡住人的从来不是什么 JSON 语法或插件开关，而是这三处关键点：g++.exe 到底在哪？PATH 有没有真正生效？tasks.json 输出的 exe 文件是否真的带了 -g？这三处只要有一处出错，后面所有的配置都只是幻觉。