“如何安装mingw-w64？一步步教你完成配置！”

2025-3-1

如何安装 MinGW-w64？一步步教你完成配置！

对于许多 Windows 上的开发者来说，拥有一个强大的、类 Unix 的编译环境是至关重要的。MinGW-w64（Minimalist GNU for Windows）正是这样一个工具集，它提供了 GCC（GNU Compiler Collection）、GNU Binutils 以及其他必要的工具，让你能够在 Windows 上编译和运行 C、C++、Fortran 等语言编写的程序。

与 Cygwin 这种提供完整 POSIX 兼容层的环境不同，MinGW-w64 的目标是尽可能地精简，直接使用 Windows API，因此编译出的程序性能更好，依赖更少，更易于分发。MinGW-w64 是 MinGW 的一个分支，解决了原版 MinGW 的一些局限性，例如对 64 位系统的支持、对最新 Windows API 的支持、以及对更多 C++11/14/17/20 特性的支持等等。

本文将详细介绍如何在 Windows 上安装和配置 MinGW-w64，包括多种安装方式，并提供一些常见问题的解决方法。

一、 为什么要选择 MinGW-w64？

在深入安装步骤之前，让我们先明确一下选择 MinGW-w64 的理由，这有助于你更好地理解它的优势和适用场景：

  • 轻量级和高性能： MinGW-w64 直接调用 Windows API，避免了像 Cygwin 那样的模拟层，因此编译出的程序体积更小，运行速度更快。
  • 原生 Windows 程序： MinGW-w64 编译出的程序是原生的 Windows 可执行文件（.exe），不依赖于任何额外的 DLL（除了你程序本身需要的），因此更容易在没有安装 MinGW-w64 的机器上运行。
  • 广泛的语言支持： GCC 支持 C、C++、Objective-C、Fortran、Ada 等多种编程语言。
  • 开源和免费： MinGW-w64 是完全开源和免费的，你可以自由地使用、修改和分发它。
  • 活跃的社区： MinGW-w64 拥有一个活跃的社区，你可以在遇到问题时寻求帮助。
  • 兼容性： 可以与多种IDE和构建系统集成，例如Code::Blocks, Eclipse, CMake, Visual Studio Code 等。

二、 MinGW-w64 的多种安装方式

MinGW-w64 提供了多种安装方式，你可以根据自己的需求和偏好选择最适合的一种：

  1. MSYS2 (强烈推荐):

    MSYS2 不仅仅是一个 MinGW-w64 的安装器，它更像是一个完整的软件包管理系统和构建平台，类似于 Linux 上的包管理器（如 apt、yum）。它提供了大量的预编译库和工具，可以极大地简化开发环境的配置。

    • 优点：

      • 包管理： 使用 pacman 命令可以轻松安装、更新和卸载软件包。
      • 多环境： 可以同时安装多个 MinGW-w64 环境（例如 32 位和 64 位，不同版本的 GCC）。
      • 预编译库丰富： 提供了大量常用的开发库，无需自己编译。
      • 类 Unix shell： 提供了 Bash shell、make 等工具，更接近 Linux 开发体验。
      • 持续更新: MSYS2的软件包仓库更新非常频繁，可以获得最新的工具链和库。

    • 安装步骤：

      1. 下载 MSYS2 安装程序： 访问 MSYS2 官网（https://www.msys2.org/），下载最新的安装程序（例如 msys2-x86_64-xxxxxxxx.exe）。

      2. 运行安装程序： 双击下载的安装程序，按照提示进行安装。建议安装到一个不包含空格或中文的路径下（例如 C:\msys64）。

      3. 首次启动 MSYS2： 安装完成后，从开始菜单中找到 "MSYS2 MSYS" 并运行。这将打开一个 MSYS2 终端窗口。

      4. 更新系统核心组件： 在 MSYS2 终端中执行以下命令：
        bash
        pacman -Syu
        如果提示需要关闭终端并重新启动，按照提示操作。重新启动后再次执行：
        bash
        pacman -Su

      5. 安装 MinGW-w64 工具链： 根据你的需要，选择安装 64 位或 32 位的工具链。

        • 64 位 (x86_64):
          bash
          pacman -S --needed base-devel mingw-w64-x86_64-toolchain
          这个命令会安装 GCC、GDB、make 等工具，以及 64 位的 MinGW-w64 运行时库。

        • 32 位 (i686):
          bash
          pacman -S --needed base-devel mingw-w64-i686-toolchain

      6. 配置环境变量（重要）： 为了让系统能够找到 MinGW-w64 的可执行文件，需要将其路径添加到系统的 PATH 环境变量中。

        • 临时添加（仅对当前终端窗口有效）：
          在 MSYS2 终端中执行（根据你的安装路径和需要选择 64 位或 32 位）：
          bash
          # 64 位
          export PATH="/mingw64/bin:$PATH"
          # 32 位
          export PATH="/mingw32/bin:$PATH"

        • 永久添加（推荐）：

          1. 右键点击“此电脑”（或“我的电脑”），选择“属性”。
          2. 点击“高级系统设置”。
          3. 点击“环境变量”。
          4. 在“系统变量”下找到名为 Path 的变量，双击它。
          5. 点击“新建”，添加 MinGW-w64 的 bin 目录的完整路径（根据你的安装路径和需要选择 64 位或 32 位）：
          6. 例如 (64 位): C:\msys64\mingw64\bin
          7. 例如 (32 位): C:\msys64\mingw32\bin
          8. 点击“确定”保存所有更改。
          9. 重要提示： 关闭所有已打开的命令提示符窗口或终端，重新打开一个新的窗口，以使环境变量生效。

      7. 验证安装： 打开一个新的命令提示符窗口（或 MSYS2 MinGW 64-bit 终端，如果你使用 MSYS2），输入以下命令：
        bash
        gcc --version
        g++ --version
        gdb --version
        如果正确显示版本信息，则说明安装成功。

  2. 独立的 MinGW-w64 安装程序 (不推荐):

虽然也可以直接从 MinGW-w64 的 SourceForge 页面（https://sourceforge.net/projects/mingw-w64/）下载独立的安装程序，但这种方式通常不推荐，因为它需要手动配置许多选项，而且不如 MSYS2 方便管理。

*   **优点：** 更小的安装包（如果你只需要最基本的编译器）。
*   **缺点：**
    *   **手动配置复杂：** 需要手动选择线程模型、异常处理机制、安装路径等。
    *   **没有包管理：** 无法方便地安装其他开发库。
    *   **更新困难：** 需要手动下载和安装更新。

*  如果你仍然选择这种方式，请务必仔细阅读官方文档，并理解各个选项的含义（例如 POSIX vs. Win32 线程模型，SEH vs. SJLJ 异常处理）。
  1. 通过 IDE 安装 (例如 Code::Blocks):

一些 IDE（如 Code::Blocks）在安装时会提供捆绑的 MinGW-w64 版本。这对于初学者来说很方便，但可能不是最新版本，而且可能无法灵活地切换不同版本的 MinGW-w64。

*   **优点:**  简单方便，适合初学者。
*   **缺点:**  版本可能较旧，灵活性较差。

三、 使用 MinGW-w64 编译程序

安装完成后，就可以开始使用 MinGW-w64 编译程序了。下面是一个简单的 C++ 程序示例：

```c++
// hello.cpp

include

int main() {
std::cout << "Hello, MinGW-w64!" << std::endl;
return 0;
}
```

使用以下命令编译程序：

bash
g++ hello.cpp -o hello.exe

这将生成一个名为 hello.exe 的可执行文件。在命令提示符窗口中运行它：

bash
./hello.exe

你应该会看到输出 "Hello, MinGW-w64!"。

四、 常见问题与解决方法

  1. gcc 或 g++ 命令找不到：

    • 原因： PATH 环境变量没有正确配置。
    • 解决方法： 仔细检查“二、MinGW-w64 的多种安装方式”中关于环境变量配置的部分，确保 MinGW-w64 的 bin 目录已经添加到 PATH 中，并且重启了命令提示符窗口。

  2. 编译时找不到头文件（例如 stdio.h、iostream）：

    • 原因： 编译器没有找到标准库的头文件。
    • 解决方法：
      • 确保你安装了完整的 MinGW-w64 工具链（包括 base-devel 和 mingw-w64-x86_64-toolchain 或 mingw-w64-i686-toolchain）。
      • 如果使用了自定义的头文件目录，可以使用 -I 选项指定包含目录： g++ -I/path/to/your/headers hello.cpp -o hello.exe

  3. 链接时找不到库文件（例如 -lstdc++）：

    • 原因： 链接器没有找到标准库或你使用的其他库。
    • 解决方法：
      • 确保你安装了需要的库。例如，如果你使用了 C++ 标准库，通常不需要显式链接 -lstdc++，因为它会被自动链接。
      • 如果使用了自定义的库文件目录，可以使用 -L 选项指定库目录： g++ hello.cpp -o hello.exe -L/path/to/your/libraries -lyourlibrary (将 yourlibrary 替换为你的库名)

  4. 编译的程序在其他机器上无法运行，提示缺少 DLL：

    • 原因： 你的程序可能依赖于 MinGW-w64 的运行时 DLL。

    • 解决方法：

      • 静态链接（推荐）： 在编译时使用 -static 选项，将所有依赖项静态链接到可执行文件中。这将生成一个更大的可执行文件，但不需要额外的 DLL。例如：
        bash
        g++ hello.cpp -o hello.exe -static
        你还可以针对特定库使用 -static-libgcc 和 -static-libstdc++ 来静态链接libgcc和libstdc++, 而其他库保持动态链接。

      • 提供 DLL： 将缺少的 DLL 文件（通常位于 MinGW-w64 的 bin 目录下）复制到可执行文件所在的目录，或将其添加到系统的 PATH 环境变量中。 不推荐这样做, 因为这会使你的程序依赖于特定的 MinGW-w64 安装。

  5. MSYS2 终端中 pacman 命令无法下载软件包：

    • 原因: 网络问题，或者镜像源速度慢。
    • 解决方法:
      • 检查你的网络连接。
      • 更换 pacman 的镜像源。编辑 /etc/pacman.d/mirrorlist.mingw64 (64位) 或 /etc/pacman.d/mirrorlist.mingw32 (32位) 文件, 将速度较快的镜像源（例如国内的清华源、中科大源）移到文件顶部。
      • 使用代理服务器。

  6. 编译 32 位程序时遇到问题 (在 64 位系统上):

    • 原因: 可能没有安装 32 位工具链, 或者链接到了 64 位的库。
    • 解决方法: 确保安装了 32 位的 MinGW-w64 工具链 (使用 pacman -S mingw-w64-i686-toolchain), 并在编译时使用 -m32 选项: g++ -m32 hello.cpp -o hello.exe

  7. 编译时出现 "undefined reference to WinMain@16" 错误:

    • 原因： 程序入口点不正确，常见于编译图形界面程序时没有使用正确的入口点函数。
    • 解决方法：
      • 对于控制台程序，确保 main 函数的定义正确。

      • 对于 GUI 程序，使用 Windows API 的 WinMain 函数作为入口点，并且需要包含 <windows.h> 头文件。 示例：

        ```c++

        include

        int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
        // 你的 GUI 程序代码
        MessageBox(NULL, "Hello, MinGW-w64!", "GUI Example", MB_OK);
        return 0;
        }

        编译时可能需要链接 `user32.lib` 和 `gdi32.lib` 等库:bash
        g++ gui.cpp -o gui.exe -mwindows -luser32 -lgdi32
        ```

五、更进一步：构建系统和 IDE 集成

当你开始开发更复杂的项目时，手动编译每个文件会变得非常繁琐。这时，你需要使用构建系统来自动化构建过程。

  • Make: Make 是一个经典的构建工具，它使用 Makefile 文件来描述项目的构建规则。MinGW-w64 自带了 make 工具。
  • CMake: CMake 是一个跨平台的构建系统生成工具。它可以生成 Makefile、Ninja 构建文件，或者 Visual Studio 项目文件等。CMake 比 Make 更现代化，更易于管理大型项目。
  • Meson: Meson是另一个现代的构建系统, 类似于CMake, 但通常被认为更快速和易用。

许多 IDE（例如 Code::Blocks, Eclipse, CLion, Visual Studio Code）都支持 MinGW-w64，你可以直接在 IDE 中配置编译器和构建系统，并进行编译、调试等操作。

以Visual Studio Code (VS Code)为例, 安装 C/C++ 扩展后, 你可以通过配置 c_cpp_properties.json 文件来指定 MinGW-w64 的编译器路径、包含路径等。 你还可以配置 tasks.json 文件来定义构建任务, 使用快捷键 (例如 Ctrl+Shift+B) 来快速构建项目。

六、 进阶使用：探索 MinGW-w64 的更多功能

MinGW-w64 不仅仅是一个编译器，它还提供了许多其他有用的工具和库：

  • GDB (GNU Debugger): 用于调试程序的工具。
  • Binutils: 包含了一系列用于处理二进制文件的工具，例如 as (汇编器)、ld (链接器)、objdump (反汇编器)、nm (列出符号表) 等。
  • MinGW-w64 运行时库： 提供了对 Windows API 的封装，以及一些 POSIX 函数的实现。
  • 通过 MSYS2 安装的各种库： 例如 SDL、OpenGL、Qt、Boost 等，可以用于开发图形界面程序、游戏、多媒体应用等。

七、 总结之外：展望未来

MinGW-w64 提供了一个在 Windows 上进行 C/C++ 开发的强大而灵活的环境。通过本文的详细介绍，你应该已经掌握了 MinGW-w64 的安装、配置和基本使用方法。MSYS2 的包管理系统极大地简化了环境搭建和维护的过程，强烈建议使用。

当然, MinGW-w64 的学习和使用是一个持续的过程，随着你对 C/C++ 编程和 Windows 开发的深入，你会发现 MinGW-w64 的更多功能和潜力。 积极探索，不断学习，你将在 Windows 开发的世界中走得更远！

希望这篇详细的教程对你有所帮助！

版权声明：
作者：admin
链接：https://hostlocvps.com/2025/03/01/%e5%a6%82%e4%bd%95%e5%ae%89%e8%a3%85mingw-w64%ef%bc%9f%e4%b8%80%e6%ad%a5%e6%ad%a5%e6%95%99%e4%bd%a0%e5%ae%8c%e6%88%90%e9%85%8d%e7%bd%ae%ef%bc%81/
文章版权归作者所有，未经允许请勿转载。
THE END
看我如何掌握zlib压缩技术！
<<上一篇
pgvector介绍：PostgreSQL中的向量数据库解决方案
下一篇>>
相关推荐
推荐几款好用的Windows/Mac FTP客户端软件
Perl编程的应用场景与核心优势解析
IP地址入门指南：概念、分类及实际应用
常见curl header用法总结：解决实际开发问题
CentOS版本检查工具与命令解析
Kotlin序列化的优点与实战案例分享
Swift GitHub开发实战：项目部署与维护
ffmpeg 安装指南：一步一步教你轻松完成
LlamaCpp深度解析：全面了解LLM的强大工具
一文搞定：Netflix 视频下载教程与常见问题解答