Windows安装配置MinGW-w64：搭建原生GCC开发环境全攻略

MinGW-w64GCCWindows

于 2026-08-04 06:58:35 修改

·本内容遵循CC 4.0 BY-SA版权协议

1. 项目缘起：为什么在Windows上折腾GCC？

如果你是一个C或C++的初学者，或者刚从Linux/macOS环境转到Windows平台做开发，第一个让你头疼的问题可能就是：我的gcc命令去哪了？在Linux下，打开终端输入gcc --version是再自然不过的事情，但在Windows的命令提示符里，它只会冷冷地回你一句“不是内部或外部命令，也不是可运行的程序”。这种感觉，就像你兴冲冲地搬进新家，却发现厨房里连把菜刀都没有。

你可能会问，Windows不是有Visual Studio和它自带的MSVC编译器吗？没错，但那是一个庞大的IDE（集成开发环境），很多时候我们只是想快速写个小程序、编译一个开源库，或者单纯地想用GNU那一套熟悉的工具链（gcc, g++, make, gdb等）。MSVC和GCC虽然都是优秀的编译器，但在一些细节上，比如对C语言标准的支持、编译选项、链接库的行为上存在差异。很多开源项目（尤其是在Linux社区诞生的）的构建脚本（如Makefile、CMakeLists.txt）默认就是为GCC/G++设计的，直接拿到MSVC上编译可能会遇到各种兼容性问题。

这时，MinGW-w64就登场了。你可以把它理解为一个“Windows版的GNU开发环境搬运工”。它的目标是将GNU编译器集合（GCC）以及相关的二进制工具、头文件和库，原汁原味地移植到Windows平台。名字里的“w64”意味着它原生支持生成64位和32位的Windows程序，这是它相对于老版本MinGW的一个重要进化。所以，安装MinGW-w64，本质上就是在你的Windows电脑上搭建一个轻量级的、命令行驱动的C/C++编译环境，让你能像在Linux终端里一样使用gcc和g++。

网上教程很多，但坑也不少。有指引到过期网站的，有下载了无法安装的，有配置完环境变量依然报错的。今天，我就以Win10系统为例，带你走一遍最清晰、最可靠的MinGW-w64下载、安装和配置全流程，确保你一次成功，把“菜刀”稳稳地拿到手。

2. 获取安装包：避开官网迷宫，直达下载镜像

这是整个过程中最容易让人迷惑和放弃的一步。如果你直接搜索“MinGW-w64官网”，很可能会找到一个叫mingw-w64.org的网站，这个网站信息更新并不及时，下载链接也可能指向一些缓慢或难以访问的源。更靠谱的做法是访问其开发团队在SourceForge上维护的发布页面。

具体操作步骤如下：

打开你的浏览器，访问SourceForge上的MinGW-w64项目页： https://sourceforge.net/projects/mingw-w64/
进入页面后，不要点击那个巨大的绿色“Download”按钮，那个按钮可能下载的是SourceForge的安装器，不是我们需要的。我们需要直接找到文件列表。
将页面往下拉，你会找到一个名为“Files”的标签页。点击它，你会看到一系列以版本号命名的文件夹，比如mingw-w64-v11.0.0/。选择最新的稳定版本文件夹进入。
进入版本文件夹后，你会看到很多以.7z或.zip结尾的压缩包，名字长得像x86_64-12.2.0-release-posix-seh-ucrt-rt_v10-rev0.7z。别慌，我们来拆解一下这个文件名，理解了它，你就能选对最适合你的版本。
- x86_64: 这表示本编译工具链是64位的，并且它能编译生成64位的目标程序。如果你想编译32位程序，需要找i686开头的版本。
- 12.2.0: 这是GCC编译器的版本号。
- release: 发行版。
- posix: 线程模型。这是关键选择之一。posix模型使用pthread库，对C++11及以后版本中的std::thread, std::mutex等多线程特性支持更好、更标准。另一个选项是win32线程模型，它使用Windows原生的线程API，但在一些高级C++多线程特性上可能有局限。对于现代C++开发，强烈建议选择posix。
- seh: 异常处理模型。seh（Structured Exception Handling）是Windows原生的、效率较高的异常处理方式。另一个选项是sjlj（Set Jump Long Jump），这是一种更古老、兼容性更广但性能稍差的方式。对于64位（x86_64）版本，选择seh；对于32位（i686）版本，通常选择dwarf或sjlj。
- ucrt: C运行时库。ucrt（Universal C Runtime）是Windows 10及以后版本推荐的现代C库。另一个选项是msvcrt，这是旧的微软C运行时库。选择ucrt能获得更好的兼容性和安全性。
- rev0: 修订版本号。

总结一下，对于大多数在Win10/Win11上进行64位C/C++开发的用户，你应该下载的文件名特征是：x86_64-...-posix-seh-ucrt-...。

找到符合要求的文件后，点击它进行下载。这是一个绿色免安装的压缩包，下载速度取决于SourceForge的镜像，有时可能较慢，请耐心等待。

3. 安装与部署：解压即用的绿色哲学

MinGW-w64的“安装”过程异常简单，因为它根本不需要安装程序。这体现了Unix哲学中的“工具”思维：一个编译器就应该是一个可以放在任何地方、通过命令行调用的程序集合。

准备目录：在你的电脑上找一个合适的位置，用来存放MinGW-w64。不建议放在包含中文或空格的路径里，虽然新版本对此支持已经好了很多，但为了避免不可预见的麻烦，最好使用全英文路径。例如，我习惯在C:\根目录下创建一个Dev文件夹，专门存放各种开发工具。那么，我们的目标路径就是C:\Dev\mingw64。
解压文件：找到你刚才下载的.7z或.zip文件。如果你没有解压软件，推荐安装7-Zip，它对各种压缩格式支持很好。右键点击下载好的压缩包，选择“解压到当前文件夹”或“解压到 x86_64-...”。你会得到一个同名文件夹。
放置文件：打开解压出来的文件夹，你会看到里面直接就是一个mingw64文件夹。将这个mingw64文件夹整体剪切或复制到你第一步准备好的目录下（例如C:\Dev\）。最终，你的编译器路径应该是C:\Dev\mingw64。

至此，编译器的所有二进制文件、头文件、库文件都已经就位了。你可以打开C:\Dev\mingw64\bin目录看看，里面充满了gcc.exe, g++.exe, gdb.exe, make.exe等可执行文件。但是，现在如果你打开命令提示符输入gcc，系统依然找不到它，因为我们还没有告诉系统去哪里找这些命令。

注意：这就是“绿色版”软件的特点。它不会向系统注册表写入信息，也不会自动修改系统环境变量。所有的配置都需要手动完成，这给了我们极大的灵活性，也要求我们理解其工作原理。

4. 配置环境变量：让系统认识你的新工具

环境变量PATH是操作系统寻找可执行文件的“寻人启事”列表。当你在命令行输入一个命令（比如gcc），系统会按照PATH变量中列出的目录顺序，依次去这些目录里查找有没有对应的.exe文件。我们的任务就是把MinGW-w64的bin目录添加到这个列表里。

Windows 10/11 配置步骤：

在桌面或开始菜单右键点击“此电脑”，选择“属性”。
在打开的窗口右侧，点击“高级系统设置”。
在弹出的“系统属性”窗口中，点击右下角的“环境变量(N)...”按钮。
这时会打开两个变量列表：上半部分是“用户变量”，只对当前登录用户生效；下半部分是“系统变量”，对所有用户生效。通常我们修改“用户变量”即可。
在“用户变量”区域，找到名为Path的变量，选中它，然后点击“编辑...”。
- 如果不存在Path变量：点击“新建”，变量名输入Path，变量值待会儿再填。
在编辑环境变量窗口中，点击“新建”，然后输入你的MinGW-w64的bin目录完整路径。例如：C:\Dev\mingw64\bin。
点击“确定”保存。非常重要的一步：你需要依次点击所有打开窗口的“确定”按钮来关闭它们，才能使更改生效。

验证配置是否成功：

关闭所有已经打开的命令提示符（CMD）或PowerShell窗口。因为环境变量的更改只对新打开的终端会话生效。
重新打开一个新的命令提示符。你可以按 Win + R，输入 cmd，然后回车。
在命令行中输入以下命令，并分别回车：

BASH

gcc --version

g++ --version

gdb --version

make --version
如果配置正确，你将看到类似以下的输出，显示了GCC、G++、GDB和Make的版本信息：

TEXT

gcc (x86_64-posix-seh-rev0, Built by MinGW-W64 project) 12.2.0

Copyright (C) 2022 Free Software Foundation, Inc.

...

看到这些信息，恭喜你！你的Windows系统现在已经认识gcc这位新朋友了。你可以像在Linux下一样，在任意目录下使用这些命令来编译你的C/C++代码了。

5. 第一个测试程序：从编译到运行

理论说得再多，不如亲手试一下。我们来完成一个经典的“Hello, World!”程序，验证整个工具链是否工作正常。

编写源代码：打开你喜欢的文本编辑器（记事本、VS Code、Notepad++等都可以）。新建一个文件，输入以下C代码：

C

#include <stdio.h>

int main() {

printf("Hello, World from MinGW-w64!\n");

return 0;

}

将文件保存到某个方便的位置，比如你的桌面，并命名为 hello.c。注意：确保你的编辑器没有偷偷给文件名加上.txt后缀。你可以在“查看”菜单中勾选“文件扩展名”来确认保存的是hello.c而不是hello.c.txt。
打开终端并导航到源代码目录：
- 在保存hello.c的文件夹中，按住 Shift 键的同时点击鼠标右键，在弹出的菜单中选择“在此处打开 PowerShell 窗口”或“在此处打开命令窗口”。
- 或者，先打开CMD，然后使用 cd 命令切换目录，例如 cd Desktop。
编译程序：在终端中输入以下命令：

BASH

gcc hello.c -o hello.exe
- gcc: 调用C编译器。
- hello.c: 指定源代码文件。
- -o hello.exe: -o 参数指定输出的可执行文件名。这里我们输出为hello.exe。如果不加-o参数，默认会生成一个叫a.exe的文件（在Linux下是a.out）。
运行程序：编译成功后，当前目录下会生成一个hello.exe文件。在终端中输入：

BASH

.\hello.exe

你应该会看到终端打印出：Hello, World from MinGW-w64!

尝试C++：你可以用几乎同样的步骤测试C++编译器。创建一个hello.cpp文件，内容如下：

CPP

# include <iostream>

int main() {

std::cout << "Hello, C++ World with MinGW-w64!" << std::endl;

return 0;

}

使用g++命令进行编译：

BASH

g++ hello.cpp -o hello_cpp.exe

.\hello_cpp.exe

如果一切顺利，你将看到C++版本的问候。这个过程清晰地展示了从源代码到可执行文件的完整链路：编辑器编写 -> 编译器编译 -> 系统运行。

6. 集成开发环境（IDE）配置示例：以VS Code为例

虽然命令行已经足够强大，但一个好的IDE能极大提升编码效率。这里以当前非常流行的VS Code为例，演示如何将其与MinGW-w64搭配使用。

安装VS Code和C/C++扩展：
- 从官网下载并安装Visual Studio Code。
- 打开VS Code，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X）。
- 在搜索框中输入“c++”，找到由Microsoft发布的“C/C++”扩展，点击安装。
打开项目文件夹：创建一个专门用于C/C++项目的文件夹，例如C:\Projects\MyCProject。在VS Code中，通过“文件”->“打开文件夹”选中这个文件夹。
配置编译器路径：VS Code的C/C++扩展需要知道你的编译器在哪里。
- 按 Ctrl+Shift+P 打开命令面板。
- 输入 “C/C++: Edit Configurations (UI)” 并选择它。这会打开一个图形化的配置界面。
- 在“编译器路径”这一项，点击下拉箭头，如果它没有自动检测到你的g++.exe，你就需要手动输入路径。点击“浏览”，然后导航到你的MinGW-w64的bin目录下，选择g++.exe（对于C++）或gcc.exe（对于C）。例如：C:\Dev\mingw64\bin\g++.exe。
- 配置完成后，VS Code会在当前项目文件夹下生成一个.vscode文件夹，里面存放着配置文件c_cpp_properties.json。
配置构建任务（Task）：为了让VS Code能一键编译，我们需要配置一个构建任务。
- 按 Ctrl+Shift+P，输入 “Tasks: Configure Default Build Task”，选择它。
- 在弹出的列表中，选择“C/C++: g++.exe build active file”（如果你正在编辑的是C++文件）或“C/C++: gcc.exe build active file”（对于C文件）。这会在.vscode文件夹下生成一个tasks.json文件。
- 这个文件定义了一个任务，当你按 Ctrl+Shift+B 时，VS Code就会调用g++或gcc来编译当前活动的源文件。
编写并运行：现在，你可以在VS Code里新建一个.c或.cpp文件，编写代码。然后按 Ctrl+Shift+B 编译。编译成功后，你可以直接在VS Code的集成终端里运行生成的可执行文件。

通过以上配置，你就拥有了一个在Windows下非常舒适、高效的C/C++开发环境，兼具了MinGW-w64强大的编译能力和VS Code优秀的编辑与调试体验。

7. 高级话题与疑难排错

即使按照步骤操作，有时也会遇到问题。这里列举几个常见坑点及其解决方案。

问题一：gcc --version 显示“不是内部或外部命令...”

原因99%是环境变量PATH配置错误或未生效。
排查步骤：
1. 在终端输入 echo %PATH%，检查输出的长长一串路径中，是否包含你的mingw64\bin目录（例如C:\Dev\mingw64\bin）。仔细核对，一个字母都不能错。
2. 如果不包含，回到第4节重新配置环境变量。配置后务必关闭所有旧终端，打开新的终端再测试。
3. 如果包含，但依然报错，检查路径中是否有中文字符或特殊符号。尝试将MinGW-w64移动到纯英文路径下，并更新PATH变量。
4. 检查bin目录下是否存在gcc.exe。有可能你下载或解压的文件不完整。

问题二：编译时提示“stdio.h: No such file or directory”

原因：编译器找不到标准头文件。这通常是因为你的MinGW-w64安装不完整或目录结构被破坏。
解决：确保你的mingw64目录结构完整。在mingw64目录下，应该存在include、lib、bin等子目录。stdio.h等头文件应该在mingw64\include里。如果缺失，建议重新下载完整的压缩包并解压。

问题三：链接时提示“undefined reference to `WinMain@16'”

原因：这是一个经典错误。你写了一个C/C++程序，但编译器在链接时认为你应该创建一个Windows GUI应用程序（需要WinMain函数），而你写的是控制台程序（需要main函数）。
解决：确保你的源代码中正确定义了main函数。对于更复杂的情况，检查你的编译命令。有时是因为你链接了某些GUI库但入口点不对。一个干净的测试方法是回到第5节，用最简单的hello.c测试。

问题四：想同时拥有32位和64位编译能力

MinGW-w64的一个工具链通常只针对一种目标架构（x86_64或i686）。如果你需要同时编译32位和64位程序，最干净的方法是分别下载x86_64和i686的两个版本，解压到两个不同的目录，例如C:\Dev\mingw64和C:\Dev\mingw32。
然后，你可以通过配置不同的环境变量或在使用时指定完整的编译器路径来切换。例如，要使用32位编译器，可以在命令行中输入完整路径：C:\Dev\mingw32\bin\gcc -m32 hello.c -o hello32.exe（注意-m32标志是告诉64位工具链生成32位代码，但更推荐直接使用对应的32位工具链）。

关于Make和CMake：

我们下载的MinGW-w64包中已经包含了make.exe。你可以直接在命令行使用make命令来执行项目中的Makefile。
对于更流行的CMake，你需要单独下载安装。安装后，在CMake配置时，指定生成器（Generator）为“MinGW Makefiles”，并指定CMAKE_C_COMPILER和CMAKE_CXX_COMPILER的路径为你MinGW-w64的gcc.exe和g++.exe，CMake就能为你生成适用于MinGW的Makefile，之后再用make编译即可。

整个过程走下来，你会发现，在Windows上搭建一个原生、高效的GCC开发环境并不复杂，核心就在于“获取正确的绿色包”和“配置好系统路径”。一旦完成，你就获得了一个与Linux/macOS开发体验高度一致的工具链，无论是学习C/C++语言本身，还是编译来自开源世界的众多项目，都会顺畅许多。这套环境也成为了许多跨平台项目在Windows上进行持续集成和测试的基石。