需安装mingw-w64并配置path，验证gcc/g++版本，编译运行hello.c，配置vs code tasks.json及code runner，排查路径、头文件、编码和子系统等常见错误。
如果您希望在Windows系统中编译C/C++源代码，但尚未配置本地编译环境，则需要先安装并正确设置MinGW工具链。以下是完成MinGW环境搭建并验证可用性的具体步骤：
一、下载并安装MinGW-w64
MinGW-w64是MinGW的现代分支，支持32位和64位目标架构，并提供较新的GCC版本。直接使用官方推荐的发行版可避免手动编译工具链的复杂性。
1、访问MinGW-w64官方下载页面，找到“Online Installer”或推荐的第三方集成包（如WinLibs或MSYS2）。
2、下载WinLibs MinGW-w64独立免安装包（例如 winlibs-x86_64-posix-seh-gcc-13.2.0-llvm-17.0.6-mingw-w64-11.0.1-r1.zip），解压至不含中文与空格的路径，例如 C:mingw64。
3、确认解压后目录中存在 bingcc.exe、bing++.exe 和 binmake.exe 等可执行文件。
二、配置系统环境变量
将MinGW-w64的bin目录添加至Windows PATH环境变量，使命令行能全局识别gcc、g++等工具。
1、右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
2、在“系统变量”区域找到并双击“Path”，点击“新建”，输入 C:mingw64in（请替换为您的实际解压路径）。
3、点击“确定”保存所有更改，关闭所有已打开的命令提示符窗口。
4、重新打开CMD或PowerShell，执行 gcc --version 和 g++ --version，确认输出显示GCC版本信息。
三、验证编译流程
通过编写并编译一个标准C程序，验证工具链是否可正常执行预处理、编译、汇编和链接全流程。
1、新建文本文件，命名为 hello.c，内容为：
#include
int main() { printf("Hello, MinGW!
"); return 0; }
2、在文件所在目录打开CMD，执行：gcc hello.c -o hello.exe。
3、执行生成的可执行文件：.hello.exe，观察终端是否输出 Hello, MinGW!。
四、配置VS Code集成开发环境
若使用VS Code作为编辑器，可通过配置tasks.json实现一键编译，提升日常开发效率。
1、在项目根目录创建 .vscode asks.json 文件，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "gcc build active file",
"command": "gcc",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}\${fileBasenameNoExtension}.exe"
],
"options": {
"cwd": "${fileDirname}"
}
}
]
}
2、在hello.c文件中按 Ctrl+Shift+B，选择“gcc build active file”，检查是否生成对应exe文件。
3、安装VS Code扩展“Code Runner”，右键选择“Run Code”，确认控制台输出结果。
五、处理常见编译错误
初学者常因路径、编码或链接问题导致编译失败，以下为高频问题及对应修正方式。
1、报错“gcc: command not found”：检查PATH是否包含正确的bin路径，且未遗漏分号或拼写错误；重启终端确保变量生效。
2、报错“fatal error: stdio.h: No such file or directory”：确认下载的是完整版MinGW-w64（含头文件和运行库），而非仅含二进制的精简包。
3、中文路径下编译失败：将源文件移至纯英文路径（如 C: esthello.c），避免GCC对UTF-8路径兼容性问题。
4、链接时提示“undefined reference to `WinMain'”：在gcc命令末尾添加 -mconsole 参数，强制生成控制台子系统程序。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
