Windows 下基于 MSYS2 搭建 C++ 开发环境：从安装到配置全指南

作为一名 C++ 开发者，在 Windows 上搭建一套顺手的开发环境，一直是很多人入门的第一道坎。MinGW、WSL、Visual Studio 各有优劣，而 MSYS2 凭借类 Linux 的包管理、完整的 GNU 工具链、对 CMake 等工具的原生支持，成为了越来越多开发者的首选。

本文将从零开始，手把手带你用 MSYS2 完成 C++ 编译器、CMake 等工具的安装与环境配置，打造一套媲美 Linux 的 Windows 开发环境，无论是日常开发、编译开源项目，还是面试刷题都能完美适配。

---

一、为什么选择 MSYS2？

在正式开始前，先聊聊为什么推荐 MSYS2，而不是传统 MinGW 或其他方案：

1. 包管理便捷 ：自带 pacman 包管理器（和 Arch Linux 同源），一键安装、更新、卸载工具，彻底告别手动下载、配置环境变量的麻烦。
2. 工具链完整：原生支持最新版 GCC/Clang、CMake、Make、Git 等全套开发工具，版本更新快，兼容性拉满。
3. 类 Linux 开发体验：提供 Bash 终端，支持 Linux 命令、Shell 脚本，完美适配 Linux 下的编译流程，跨平台开发无压力。
4. 多架构支持：同时支持 x86_64（64 位）、aarch64（ARM64）等架构，适配不同硬件需求。
5. 轻量灵活：相比 Visual Studio 动辄十几 G 的体积，MSYS2 安装包仅几百 M，按需安装工具，不占用过多系统资源。

二、MSYS2 安装与基础配置

1. 下载与安装 MSYS2

• 官方下载 ：访问MSYS2 官网，根据你的系统架构（主流为 64 位 Windows）下载最新安装包 msys2-x86_64-xxx.exe。
• 安装步骤：
  1. 双击安装包，选择安装路径（强烈建议使用纯英文路径，无空格、无中文 ，例如 D:\msys64，避免后续编译出现路径问题）。
  2. 保持默认配置，一路点击「下一步」完成安装。
  3. 安装完成后，桌面会生成多个 MSYS2 终端快捷方式，我们常用的是 MSYS2 MINGW64（对应 64 位 MinGW 工具链）。

补充：不同终端的区别

• MSYS2 MSYS：基础 MSYS 环境，用于类 Linux 命令，不推荐用于 C++ 开发。
• MSYS2 MINGW64：64 位 MinGW 环境，用于编译 64 位 Windows 程序，是我们的主力环境。
• MSYS2 MINGW32：32 位 MinGW 环境，用于编译 32 位程序，按需使用。

2. 初始化与源更新

安装完成后，首次打开 MSYS2 MINGW64 终端，先执行源更新命令，确保后续安装工具顺利：

# 更新包数据库
pacman -Syy
# 升级系统中已安装的所有包（首次安装建议执行）
pacman -Syu

注意：执行升级命令后，终端会自动关闭，重新打开 MINGW64 终端，再次执行 pacman -Syu 直到无包可更新，完成系统初始化。

三、安装 C++ 编译器（GCC/Clang）

MSYS2 提供了两套主流 C++ 编译器：GCC（GNU 编译器集合） 和 Clang，我们可以按需安装。

1. 安装 GCC（最常用，兼容性最好）

GCC 是 C++ 开发的标准编译器，支持 C++11/14/17/20/23 等最新标准，绝大多数开源项目都基于 GCC 编译。在 MINGW64 终端执行：

# 安装 64 位 GCC 工具链（包含 g++、gcc、make 等全套工具）
pacman -S mingw-w64-x86_64-gcc

安装完成后，验证是否安装成功：

# 查看 g++ 版本
g++ --version
# 查看 gcc 版本
gcc --version
# 查看 make 版本
make --version

如果正常输出版本信息（例如 g++ (GCC) 13.2.0），说明 GCC 安装成功。

2. 安装 Clang（LLVM 编译器，适合跨平台 / 性能优化）

Clang 是 LLVM 项目的编译器，编译速度更快、报错信息更友好，适合 iOS/Android 跨平台开发，或追求极致编译体验的开发者。在 MINGW64 终端执行：

# 安装 64 位 Clang 工具链
pacman -S mingw-w64-x86_64-clang

验证安装：

clang --version
clang++ --version

小技巧：MSYS2 同时支持 GCC 和 Clang，可通过 g++/clang++ 自由切换编译器，无需额外配置。

四、安装 CMake 与构建工具

CMake 是目前最主流的跨平台构建工具，几乎所有现代 C++ 项目都基于 CMake 管理编译流程，我们需要安装 CMake 及配套工具。

1. 安装 CMake

在 MINGW64 终端执行：

# 安装 64 位 CMake
pacman -S mingw-w64-x86_64-cmake

验证安装：

cmake --version

正常输出版本信息（例如 cmake version 3.28.3），说明安装成功。

2. 安装 Ninja（可选，加速编译）

Ninja 是一款轻量、高速的构建工具，相比 Make 编译速度更快，尤其适合大型 C++ 项目，强烈建议安装：

pacman -S mingw-w64-x86_64-ninja

验证：

ninja --version

后续使用 CMake 时，可通过 -G Ninja 指定用 Ninja 构建，大幅提升编译效率。

3. 其他常用工具（按需安装）

# 安装 Git（版本控制必备）
pacman -S git
# 安装 gdb（C++ 调试工具）
pacman -S mingw-w64-x86_64-gdb
# 安装 clang-format（代码格式化工具）
pacman -S mingw-w64-x86_64-clang-tools-extra

五、环境变量配置（让 Windows 全局识别工具）

默认情况下，MSYS2 的工具仅能在 MINGW64 终端中使用。如果想在 Windows 自带的 CMD、PowerShell 或 IDE（如 VS Code、CLion）中直接使用 g++、cmake 等命令，需要配置系统环境变量。

1. 添加环境变量

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
2. 在「系统变量」中找到 Path，点击「编辑」。
3. 点击「新建」，添加以下 2 个路径（替换为你自己的 MSYS2 安装路径）：
   • D:\msys64\mingw64\bin（核心：包含 g++、cmake、make 等工具）
   • D:\msys64\usr\bin（可选：包含 bash、git 等 Linux 命令）
4. 点击「确定」保存所有配置，重启 CMD / 终端 使环境变量生效。

2. 验证全局环境

打开 Windows 自带的 CMD 或 PowerShell，执行：

g++ --version
cmake --version
make --version

如果正常输出版本信息，说明环境变量配置成功，现在可以在 Windows 任意位置使用这些工具了。

六、第一个 C++ 程序：编译与运行

环境搭建完成后，我们来写一个简单的 C++ 程序，验证整个流程是否正常。

1. 编写代码

在任意目录（例如 D:\code）新建 hello.cpp，内容如下：

#include <iostream>
using namespace std;

int main() {
    cout << "Hello MSYS2 C++!" << endl;
    cout << "GCC 版本: " << __VERSION__ << endl;
    return 0;
}

2. 编译运行（GCC 方式）

打开 CMD 或 MINGW64 终端，进入代码目录，执行编译：

# 编译代码，生成可执行文件 hello.exe
g++ hello.cpp -o hello
# 运行程序
./hello

如果输出：

Hello MSYS2 C++!
GCC 版本: 13.2.0

说明编译器、环境配置完全正常！

3. CMake 构建示例（现代项目流程）

对于大型项目，我们用 CMake 管理构建流程，演示一个标准 CMake 项目：

1. 目录结构：

   plaintext

   D:\code\cmake_demo
   ├── CMakeLists.txt
   └── src
       └── main.cpp

2. src/main.cpp 内容同上 hello.cpp。

3. CMakeLists.txt 内容：

   cmake_minimum_required(VERSION 3.16)
   project(HelloMSYS2 VERSION 1.0 LANGUAGES CXX)
   
   set(CMAKE_CXX_STANDARD 17)
   set(CMAKE_CXX_STANDARD_REQUIRED ON)
   
   add_executable(hello src/main.cpp)

4. 构建流程：

   # 进入项目目录
   cd D:\code\cmake_demo
   # 创建构建目录（推荐 out-of-source 构建）
   mkdir build && cd build
   # 生成 Makefile（用 Ninja 则替换为 cmake -G Ninja ..）
   cmake ..
   # 编译
   make
   # 运行
   ./hello

完美运行，说明 CMake 环境也配置正常。

---

七、IDE 集成（VS Code / CLion）

1. VS Code 配置

1. 安装 VS Code 插件：C/C++、CMake、CMake Tools。
2. 打开 VS Code，按 Ctrl+Shift+P，输入 CMake: Select a Kit，选择 GCC 13.2.0 x86_64-w64-mingw32（对应 MSYS2 的 GCC）。
3. 配置完成后，即可直接在 VS Code 中编译、调试 C++ 项目，无需手动操作终端。

2. CLion 配置

1. 打开 CLion，进入 File → Settings → Build, Execution, Deployment → Toolchains。
2. 点击 +，选择 MinGW，在 Environment 中选择 MSYS2 的 mingw64 目录（例如 D:\msys64\mingw64）。
3. CLion 会自动识别 g++、cmake、gdb 等工具，点击 OK 完成配置，直接创建 / 编译 C++ 项目。

---

八、常见问题与避坑指南

1. 中文乱码问题

MSYS2 终端默认编码为 UTF-8，Windows CMD 为 GBK，可能出现中文乱码，解决方案：

• 在 MINGW64 终端执行：echo "export LANG=zh_CN.UTF-8" >> ~/.bashrc，重启终端生效。
• 在 CMD 中执行 chcp 65001，临时切换为 UTF-8 编码，或永久修改系统编码为 UTF-8。

2. 编译报错：找不到头文件 / 库

• 检查是否在 MINGW64 终端 中执行编译（不要用 MSYS 终端）。
• 检查环境变量是否正确，确保 mingw64\bin 路径在系统 Path 中。
• 安装对应依赖库：例如需要 Boost 库，执行 pacman -S mingw-w64-x86_64-boost 即可。

3. 安装慢 / 源超时

MSYS2 默认源在海外，国内用户可替换为清华源，大幅提升下载速度：

1. 编辑 /etc/pacman.d/mirrorlist.mingw64，在文件开头添加：

   Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/mingw/x86_64/

2. 编辑 /etc/pacman.d/mirrorlist.msys，在文件开头添加：

   Server = https://mirrors.tuna.tsinghua.edu.cn/msys2/msys/$arch/

3. 执行 pacman -Syy 更新源，后续安装速度大幅提升。

4. 权限不足报错

MSYS2 终端默认普通用户权限，安装系统级工具时可能报错，不要用管理员身份运行终端 ，MSYS2 自带 pacman 权限管理，直接执行命令即可，管理员权限反而会导致权限混乱。

---

九、总结

通过 MSYS2 搭建 C++ 开发环境，我们用一套轻量、灵活的方案，在 Windows 上实现了媲美 Linux 的开发体验：

• 用 pacman 一键管理工具，告别手动配置的繁琐；
• 最新版 GCC/Clang + CMake，完美适配现代 C++ 开发；
• 类 Linux 终端 + 环境变量配置，兼容 IDE 与命令行开发。

这套环境不仅适合日常 C++ 学习、刷题，更能胜任开源项目编译、跨平台开发、面试准备等场景，是 Windows 下 C++ 开发的最优解之一。

如果你在配置过程中遇到问题，欢迎在评论区留言交流！