验证gcc可用性是首要步骤：在全新cmd/powershell中运行g++ --version，必须显示版本号；若提示“不是内部或外部命令”，说明bin目录未加入path或未重启终端；路径含空格或中文会导致tasks.json解析失败。
装完 GCC（或 MinGW-w64）只是第一步，VS Code 本身不认它——必须手动告诉编辑器“编译器在哪”“用什么标准”“头文件去哪找”，否则 cout 报红、#include <iostream></iostream> 找不到、F5 调试直接报错“无法启动程序”，全是配置没对。
怎么验证 GCC 真的可用
别跳过这步。很多问题其实卡在环境变量没生效，而不是 VS Code 配置错了。
- 打开全新 cmd 或 PowerShell（不是旧终端窗口），输入
g++ --version，必须看到类似g++ (MinGW-W64 x86_64-ucrt-posix-seh-rev0) 14.2.0的输出 - 如果提示“不是内部或外部命令”，说明
bin目录没加进Path，或者加了但没重启终端 - 如果显示版本但路径含空格或中文（比如
C:Program Filesmingw64in），后续 tasks.json 极可能因路径解析失败而编译中断
VS Code 里必须改的三个文件
VS Code 的 C++ 支持靠四个 JSON 文件协同工作，但新手只需动其中三个，且顺序不能乱：
-
c_cpp_properties.json：只管“代码编辑时的智能提示和报错”。重点配"compilerPath"（填绝对路径，如"C:\mingw64\bin\g++.exe"）和"cppStandard"（建议设为"c++20"）；"includePath"别手抖往里加系统头文件路径，VS Code 会自动推导 -
tasks.json：只管“Ctrl+Shift+B 怎么编译”。关键看"command"是否指向你本地的g++.exe，"args"里必须有-g（生成调试信息）和-std=c++20（避免默认用老标准）；若用 MSYS2 安装，"command"很可能是"C:\msys64\ucrt64\bin\g++.exe" -
launch.json：只管“F5 怎么调试”。核心是"program"字段要匹配tasks.json里-o输出的路径，例如"${fileDirname}\${fileBasenameNoExtension}.exe"；如果想在外部终端运行（比如需要输入），加一行"externalConsole": true
常见报错和对应解法
这些错误出现频率高，但原因高度集中：
-
cannot open source file "iostream"：90% 是c_cpp_properties.json里"compilerPath"指错了，或路径用了正斜杠/没转义成双反斜杠\ -
undefined reference to `WinMain'：tasks.json编译参数漏了-mconsole（Windows 下控制台程序必须加） - F5 启动后一闪退：没加
"externalConsole": true，程序在内置终端跑完就关；或launch.json里"program"路径和实际生成的 .exe 名字对不上（比如 main.cpp 编译出 main.exe，但配置写成了"main.out"） - 中文输出乱码（Windows）：不是编码问题，是
g++默认用 GBK，但 VS Code 终端用 UTF-8；临时解法是在tasks.json的"args"里加-fexec-charset=GBK，长期建议统一用 UTF-8 +setlocale(LC_ALL, "zh_CN.UTF-8")
最易被忽略的是：每次改完 c_cpp_properties.json 或 tasks.json，必须关闭再重开 VS Code 窗口（不是仅重启窗口），否则旧缓存不刷新，改了也白改。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
