CLion + MSYS2（MinGW64）C++ 开发环境完整配置指南（Windows）

本文面向 Windows 平台 C++ 初学者与工程入门用户，目标是帮助你在 CLion + MSYS2（MinGW64） 环境下，一次性完成稳定、规范、可长期使用的 C++ 开发环境配置。

本教程特点：

• 零基础可照做
• 不依赖 Visual Studio
• 避开常见工具链与编码陷阱
• 配置完成即可直接进入 C++ 学习或工程开发

一、准备说明

在开始之前，请确认以下几点：

• 操作系统：Windows 10 / Windows 11
• 本教程 仅使用 MSYS2 的 MinGW64 工具链
• 不要混用 MSYS / UCRT64 / 其他 MinGW 发行版

说明：CLion 对工具链 ABI 要求较严格，混用环境极易导致编译或调试失败。

二、第一步：下载并安装 CLion

1. 下载地址

官方地址（Windows）https://www.jetbrains.com/zh-cn/clion/download/?section=windows

直接下载 Windows 版 .exe 安装包，无需区分 32/64 位。

2. 安装过程说明

运行下载好的 .exe 文件，安装过程中：

• 建议全部勾选默认选项
• “将当前目录作为工作空间”可选
• 自动添加到环境变量建议勾选（避免手动配置 PATH）

安装完成后，按提示完成注册或试用即可。

三、第二步：下载并安装 MSYS2

1. 下载 MSYS2

官网地址： https://www.msys2.org/

请选择 x86_64 版本（64 位）。

2. 安装路径要求（非常重要）

• 路径中 不能包含中文、空格或特殊符号
• 推荐路径示例：

D:\msys64

3. 验证安装

安装完成后，开始菜单中应能看到并打开：

MSYS2 MinGW64

注意：MSYS2 会安装多个终端，请务必使用 MinGW64，不要打开 MSYS 或 UCRT64。

能正常打开即表示安装成功。

四、第三步：安装 C++ 编译器、调试器与构建工具

以下操作 全部在 MSYS2 MinGW64 终端中完成。

注意：MSYS2 会安装多个终端，请务必使用「MSYS2 MinGW64」，
不要使用 MSYS 或 UCRT64，否则可能导致编译或调试失败。

1. 更新系统包

首次打开终端后执行：

pacman -Syu

如果过程中出现窗口关闭或提示重新打开终端，这是正常行为。请重新打开 MSYS2 MinGW64，再次执行：

pacman -Syu

直到提示没有可更新内容为止。

2. 安装 MinGW64 开发工具链

在同一终端中执行：

pacman -S --needed \

mingw-w64-x86_64-gcc \

mingw-w64-x86_64-gdb \

mingw-w64-x86_64-cmake \

mingw-w64-x86_64-ninja

全部输入 Y 确认，等待安装完成。

3. 验证安装是否成功

依次执行：

gcc --version

g++ --version

cmake --version

ninja --version

只要没有出现 command not found，说明工具链安装成功。

提示：C++ 项目 必须确保 g++ 可用，仅有 gcc 不够。

五、第四步：在 CLion 中配置 MinGW 工具链

1. 打开工具链设置

路径：

Settings → Build, Execution, Deployment → Toolchains

设置→构建，执行，部署→工具链

2. 删除已有工具链

• 如果左侧已有工具链，请全部选中并删除
• 新环境下通常是空的

3. 新建 MinGW 工具链

点击 Add → 选择 MinGW，然后按如下配置（路径仅供参考 具体请以你的实际安装路径为准）：

• CMake：Bundled
• Debugger：（调试器）

C++ Compiler：（C++编译器）

D:\msys64\mingw64\bin\g++.exe

C Compiler：（C编译器）

D:\msys64\mingw64\bin\gcc.exe

Build tool：（构建工具）

D:\msys64\mingw64\bin\ninja.exe

Toolset：（工具集）

D:\msys64\mingw64

Bundled GDB（捆绑的GDB）

大概就和下列图片一样

如果出现警告提示，无需惊慌，直接点击 应用 即可。

六、第五步：编写并运行第一行 C++ 代码

1. 新建 C++ 工程或 .cpp 文件

在 CLion 中新建 C++ Executable 项目，或新建一个 main.cpp 文件。

2. 示例代码

#include <iostream> int main() { std::cout << "Hello, C++!" << std::endl; return 0; } 

3. 运行程序

点击运行按钮，若终端输出：

Hello, C++!

说明环境配置成功，你已经可以开始正式学习和使用 C++ 了。

结语

至此，你已经完成了 CLion + MSYS2（MinGW64） 在 Windows 下的完整 C++ 开发环境配置。

该环境适合：

• C++ 初学
• 算法练习
• 工程开发
• 后续深入学习现代 C++（C++11 及以后）

后续你可以直接进入 C++ 基础语法或工程实践阶段。