Windows 10 下构建原生 C/C++ 开发环境：MinGW-w64 深度配置与实战指南

如果你是一名刚刚接触 C 或 C++ 开发的 Windows 用户，面对 Visual Studio 的庞大体积和复杂的项目配置，可能会感到一丝迷茫。你或许只是想快速写几行代码，验证一个算法，或者编译一个来自开源社区的小工具，却不想为此安装一个动辄几十 GB 的“巨无霸”。这种时候，一个轻量、纯粹、类 Unix 风格的命令行编译环境就显得格外诱人。MinGW-w64 正是为此而生——它不是某个庞大 IDE 的附庸，而是一套让你能在 Windows 命令提示符或 PowerShell 中，直接使用经典的 gcc、g++、make 等工具链的独立解决方案。今天，我们就来彻底搞定它在 Windows 10 上的部署，并深入探索其配置细节与实用技巧，让你获得一个高效、干净的原生开发环境。

1. 理解 MinGW-w64：不只是另一个编译器

在开始点击下载按钮之前，我们有必要花点时间弄清楚 MinGW-w64 究竟是什么，以及它和 MinGW、Cygwin、WSL 这些听起来相似的技术有何本质区别。这能帮你做出更合适的选择，并理解后续每一步操作的意义。

MinGW-w64 是 “Minimalist GNU for Windows 64-bit” 的缩写，但其实际支持 32 位和 64 位。它的核心目标是将 GNU 编译器集合（GCC）以及相关的二进制工具（如 ld, ar, as）、头文件和库，完整地移植到 Windows 平台。与 Cygwin 不同，MinGW-w64 编译出的程序是原生的 Windows 可执行文件（.exe），不依赖额外的 POSIX 模拟层 DLL。这意味着程序运行效率更高，部署也更简单——用户不需要安装任何额外运行时库。而与 Windows Subsystem for Linux (WSL) 相比，MinGW-w64 运行在纯粹的 Windows 环境下，生成的程序也是标准的 Windows 二进制文件，更适合需要与 Windows API 深度交互或进行本地部署的场景。

当前，MinGW-w64 项目已经基本取代了早期的 MinGW（后者主要维护 32 位支持）。对于现代 Windows 10/11 64 位系统，我们应直接选择 MinGW-w64。它的一个发行版通常包含以下核心组件：

  • gcc-core: C 语言编译器。
  • gcc-g++: C++ 语言编译器。
  • binutils: 包含链接器（ld）、汇编器（as）、归档工具（ar）等。
  • mingw-w64-crt: 针对 Windows 的 C 运行时库实现。
  • headers: Windows API 头文件。

在下载时，你会面临几个关键选择，它们决定了工具链的特性和兼容性：

选项可选值说明与推荐
架构 (Architecture)x86_64 / i686x86_64 用于生成 64 位程序；i686 用于生成 32 位程序。对于现代电脑，选择 x86_64。
线程模型 (Threads)posix / win32决定 C++ 标准库中 <thread> 和 <future> 的实现。如果你需要进行跨平台开发（特别是涉及多线程），或使用某些依赖 POSIX 线程语义的库（如 Boost），选择 posix。如果仅进行纯 Windows 开发，win32 亦可。目前 posix 是更通用、兼容性更好的选择。
异常处理 (Exception)seh / sjlj / dwarfseh (结构化异常处理) 是现代 64 位 Windows 的原生机制，性能更好，推荐用于 x86_64。sjlj (Set Jump Long Jump) 较旧，稳定性高，同时支持 32/64 位。dwarf 主要用于 32 位 (i686)。因此，对于 x86_64 + posix，组合通常为 seh。

提示：一个常见且推荐的组合是 x86_64-posix-seh。这个组合能提供良好的性能和对现代 C++ 多线程特性的支持。

2. 获取与部署：避开下载陷阱，选择高效方案

网络上很多教程会引导你到 SourceForge 下载一个名为 mingw-get-setup.exe 的安装管理器。这个管理器需要在线下载包列表和组件，由于服务器位于国外，整个过程可能极其缓慢且容易失败。对于国内用户，这不是一个理想的选择。

更高效、更直接的方法是下载预编译好的离线压缩包，解压即用。一个可靠的来源是 GitHub 上的 mingw-builds 项目发布页。

步骤 1：下载离线压缩包

  1. 打开浏览器，访问以下地址：
    https://github.com/niXman/mingw-builds-binaries/releases
  2. 在 Releases 页面中，找到最新的版本发布。你会看到一系列命名格式如 x86_64-13.2.0-release-posix-seh-ucrt-rt_v11-rev1.7z 的文件。
  3. 根据上一节的讨论，选择对应的版本。例如，下载 x86_64-13.2.0-release-posix-seh-ucrt-rt_v11-rev1.7z。
    • x86_64: 64位架构
    • posix: 线程模型
    • seh: 异常处理
    • ucrt: 运行时库（Universal C Runtime，Win10 后推荐）
  4. 点击该文件链接开始下载。由于是 GitHub 直连，下载速度通常比较可观。

步骤 2：解压与目录规划

下载完成后，你会得到一个 .7z 压缩文件。你需要使用解压工具（如 7-Zip、Bandizip）将其解压。

  • 解压目标：选择一个你拥有读写权限、且路径中不含中文和空格的目录。例如：
    • D:\Development\mingw64
    • C:\Tools\mingw64
    • 避免使用 C:\Program Files 或 C:\用户\... 这类路径，以防权限和空格引发问题。

解压后，目录结构应大致如下：

D:\Development\mingw64
├── bin/          # 核心工具所在，如 gcc.exe, g++.exe, gdb.exe
├── include/      # 系统头文件
├── lib/          # 静态库和导入库
├── libexec/      # 编译器内部工具
├── share/        # 文档等共享数据
└── x86_64-w64-mingw32/  # 目标平台特定文件

此刻，编译器实际上已经“安装”好了，只不过系统还不知道它的存在。

3. 配置环境变量：让系统识别你的工具链

环境变量是操作系统和应用程序用来定位可执行文件、库和配置信息的键值对。我们需要将 MinGW-w64 的 bin 目录添加到系统的 PATH 变量中，这样无论在哪个目录打开命令行，系统都能找到 gcc、g++ 等命令。

通过图形界面配置（推荐给初学者）

  1. 在 Windows 搜索栏输入“环境变量”，选择“编辑系统环境变量”。
  2. 在弹出的“系统属性”窗口中，点击右下角的“环境变量(N)...”按钮。
  3. 在“环境变量”窗口的下半部分“系统变量(S)”区域，找到并选中名为 Path 的变量，点击“编辑...”。
  4. 在“编辑环境变量”窗口中，点击“新建(N)”，然后将你的 MinGW-w64 的 bin 目录的完整路径粘贴进去。例如：D:\Development\mingw64\bin。
  5. 点击“确定”保存所有打开的窗口。

通过 PowerShell 快速配置（适合喜欢命令行的用户）

如果你熟悉 PowerShell，可以用一行命令完成添加（需要管理员权限）：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";D:\Development\mingw64\bin", [EnvironmentVariableTarget]::Machine)

这条命令将路径追加到了系统级的 PATH 变量中。执行后，需要重新启动任何已打开的命令行终端（包括 PowerShell 和 CMD），新的环境变量才会生效。

注意：修改 PATH 后，务必关闭所有现有的命令行窗口并重新打开，否则新的路径不会加载。验证时请使用新打开的终端。

4. 验证安装与编写第一个程序

环境变量配置完成后，让我们进行最终测试，并迈出编码第一步。

验证编译器

  1. 按下 Win + R，输入 cmd 或 powershell，打开一个新的命令提示符或 PowerShell 窗口。
  2. 输入以下命令并回车：
    gcc --version
g++ --version
    如果配置成功，你将看到类似以下的输出，显示了 GCC 的详细版本信息：
    gcc (x86_64-posix-seh-rev1, Built by MinGW-W64 project) 13.2.0
Copyright (C) 2023 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    同样地，g++ --version 也会显示对应的 C++ 编译器信息。这证明你的 MinGW-w64 已经准备就绪。

创建并编译你的第一个 C 程序

让我们告别枯燥的配置，写点实际的代码。

  1. 在你喜欢的位置（例如桌面或文档文件夹）新建一个文本文件，将其重命名为 hello.c。注意：确保文件扩展名是 .c，而不是 .c.txt。如果看不到扩展名，需要在文件资源管理器的“查看”选项中勾选“文件扩展名”。
  2. 用记事本或其他文本编辑器（如 VS Code、Notepad++）打开 hello.c，输入以下经典代码：
    #include <stdio.h>

int main() {
    printf("Hello, MinGW-w64 World!\n");
    return 0;
}
  3. 保存文件。
  4. 打开命令行，使用 cd 命令切换到 hello.c 文件所在的目录。例如，如果文件在桌面：
    cd %USERPROFILE%\Desktop
  5. 使用 gcc 命令编译这个 C 程序：
    gcc hello.c -o hello.exe
    • hello.c：源文件。
    • -o hello.exe：指定输出的可执行文件名为 hello.exe。如果不加 -o 参数，默认会生成 a.exe。
  6. 如果编译没有报错，目录下会生成一个 hello.exe 文件。在命令行中直接输入其名称运行：
    hello.exe
    你将看到终端输出：Hello, MinGW-w64 World!。

创建并编译你的第一个 C++ 程序

过程类似，只是换用 g++ 编译器。

  1. 创建 hello.cpp 文件，内容如下：
    #include <iostream>

int main() {
    std::cout << "Hello from C++ with MinGW-w64!" << std::endl;
    return 0;
}
  2. 在对应目录下编译：
    g++ hello.cpp -o hello_cpp.exe
  3. 运行：
    hello_cpp.exe

至此，你已经成功搭建了一个完全独立于大型 IDE 的 C/C++ 命令行编译环境。这个环境轻便、快速，非常适合学习语言本身、编写脚本工具或编译小型项目。

5. 进阶配置与工具集成

基础环境搭建完成后，我们可以考虑一些增强体验的配置，并了解如何将 MinGW-w64 与流行的代码编辑器结合使用。

使用 Make 进行项目管理

对于多文件项目，手动编译每个文件并链接非常繁琐。make 工具可以自动化这个过程。MinGW-w64 的 bin 目录里通常包含 mingw32-make.exe。为了方便，我们可以为其创建一个简单的别名或重命名。

  1. 找到 mingw64\bin\mingw32-make.exe。
  2. 将其复制一份，并重命名为 make.exe（或者创建一个名为 make 的批处理文件来调用它）。
  3. 现在，你可以在项目目录中创建一个名为 Makefile 的文件来定义构建规则。例如，一个简单的 Makefile 可能如下：
    CC = gcc
CFLAGS = -Wall -Wextra -O2
TARGET = myprogram
SOURCES = main.c utils.c
OBJECTS = $(SOURCES:.c=.o)

all: $(TARGET)

$(TARGET): $(OBJECTS)
    $(CC) $(OBJECTS) -o $(TARGET)

%.o: %.c
    $(CC) $(CFLAGS) -c $< -o $@

clean:
    del *.o $(TARGET).exe

.PHONY: all clean
  4. 在命令行中，只需输入 make 即可自动编译，输入 make clean 即可清理生成的文件。

与 Visual Studio Code 集成

VS Code 是一个强大的轻量级编辑器，通过安装扩展可以完美支持 MinGW-w64。

  1. 在 VS Code 中安装官方扩展 “C/C++” (由 Microsoft 发布)。
  2. 打开你的 C/C++ 项目文件夹。
  3. 按下 Ctrl+Shift+P，输入 “C/C++: Edit Configurations (UI)”，回车。
  4. 在配置界面中，找到 “Compiler path”。点击浏览按钮 (...)，导航到你的 mingw64\bin 目录，选择 gcc.exe（用于 C）或 g++.exe（用于 C++）。VS Code 会自动检测到包含路径和定义。
  5. 找到 “IntelliSense mode”，选择 windows-gcc-x64。
  6. 你还可以配置 tasks.json 来定义自定义的构建任务（如调用 make），以及 launch.json 来配置调试（需要配合 MinGW-w64 自带的 gdb.exe）。

配置完成后，VS Code 将提供代码补全、语法高亮、错误检查、一键编译运行和调试等功能，体验堪比 IDE，但保留了底层工具链的透明性和灵活性。

处理常见问题：动态链接库缺失

有时，编译成功的 .exe 文件在另一台没有安装 MinGW-w64 的电脑上运行时，可能会报错“找不到 libgcc_s_seh-1.dll”或类似的动态链接库缺失错误。这是因为你的程序动态链接了 MinGW-w64 的运行时库。

有两种解决方案：

  1. 静态链接：在编译时加上 -static 参数，将必要的库静态打包进可执行文件，这样生成的文件会变大，但可以独立运行。
    gcc hello.c -o hello_static.exe -static
  2. 分发 DLL：将 mingw64\bin 目录下报错的 DLL 文件（如 libgcc_s_seh-1.dll, libstdc++-6.dll, libwinpthread-1.dll）与你的 .exe 文件放在同一目录下一同分发。

对于发布给最终用户的程序，静态链接通常是更干净的选择。

6. 探索更多可能：从基础编译到现代工作流

掌握了 MinGW-w64 的核心用法后，你的 Windows 命令行就变成了一个强大的开发工作站。你可以用它来：

  • 编译开源项目：许多使用 Autotools (./configure && make) 或 CMake 的跨平台项目，都可以在 MinGW-w64 环境下编译。对于 CMake，你需要指定生成器为 MinGW Makefiles：
    cmake -G "MinGW Makefiles" -B build .
cd build
make
  • 使用包管理器：虽然不如 Linux 下丰富，但你可以通过 MSYS2（一个基于 MinGW-w64 的独立环境）来使用 pacman 包管理器，轻松安装数百个开发库和工具。MSYS2 提供了更完整的类 Unix 环境和便捷的库管理，是进阶用户的绝佳选择。
  • 交叉编译：MinGW-w64 本身就可以被视为一个“交叉编译器”，因为它在一个平台（Windows）上生成另一个平台（Windows）的代码。理解了这一点后，你可以进一步研究如何使用它进行真正的跨平台交叉编译（例如，在 Linux 上编译 Windows 程序）。

回顾整个配置过程，最关键的步骤其实就两个：下载正确的离线包和准确配置 PATH 环境变量。一旦打通了这个环节，你就解锁了一种高效、直接的开发方式。我个人在维护一些小型工具或快速原型时，非常偏爱这种“编辑器+命令行工具链”的模式，它让编译过程变得清晰可见，也让我对项目的构建依赖有了更强的掌控力。如果你在后续使用中遇到了奇怪的编译错误，不妨首先检查环境变量是否生效、路径中是否有空格或特殊字符，以及编译命令的参数是否正确——大多数问题都源于这些基础的配置细节。

Logo
乐奇 Rokid 开放社区

更多推荐

cover

一句话打造「丢哪里」垃圾分类AIUI智能体

avatar 乐奇 Rokid 开放社区
cover

“什么值得买”兴趣消费服务接入乐奇AI眼镜，开启“看见即搜索”新体验

avatar 乐奇 Rokid 开放社区
cover

从源码拆解一个 AIUI 每日一词智能体：页面、离线索引与硬件交互

avatar 乐奇 Rokid 开放社区