CLion 默认自带 MinGW-w64 13.1(含 C/C++、POSIX 线程、SEH 异常),开箱即用,无需额外下载或配置环境变量;其捆绑 GDB 已预置 Python 支持,可正确渲染 STL 容器,避免 ABI 不匹配导致的调试失败。

CLion 默认自带 MinGW-w64 13.1(含 c、c++、posix 线程、seh 异常),开箱即用,**不需要额外下载或配置环境变量**——这是最简路径,也是官方推荐的起点。
为什么不用自己装 MinGW?
手动安装 MinGW 容易踩坑,尤其是 ABI 不匹配导致调试失败、gdb 无法加载 Python 渲染器、或链接时找不到 libstdc++。CLion 捆绑的 MinGW-w64 已预编译并验证兼容性,gdb 带 Python 支持,能正确显示 std::vector、std::string 等容器内容。
- 如果你只写标准 C++ 项目(无 Qt、无 Boost、无自定义构建脚本),直接用
Bundled MinGW即可 - 若需
UCRT运行时(如对接某些 Windows SDK)、或必须用msvcrtABI,才考虑 MSYS2 或自定义 MinGW-w64 -
mingw.org的旧版 MinGW(仅 32 位)已不被 CLion 2024.2+ 支持,会报Compiler not found
如何启用 Bundled MinGW 工具链
打开 File | Settings | Build, Execution, Deployment | Toolchains,点击 + → 选择 MinGW。此时 Toolset 字段默认为 Bundled MinGW,无需修改路径。
- 确保
Debugger选的是Bundled GDB(不是系统 GDB 或自定义路径) - 如果右侧显示
Not detected,检查是否误删了bin/mingw目录(常见于手动清理 CLion 缓存) - 不建议勾选
Initialize environment with script,除非你明确需要在编译前执行 shell 初始化逻辑
什么时候必须换自定义 MinGW?
典型场景只有三个:Qt 项目需匹配 Qt 官方 MinGW 构建版本、使用 cmake -G "MinGW Makefiles" 手动调用、或团队要求统一工具链路径。
- 路径必须指向包含
bin/g++.exe和bin/gdb.exe的目录,例如D:\msys64\mingw64或C:\mingw64 - 若 CLion 报
Cannot detect compiler,打开 MinGW 安装目录,确认存在bin/gcc.exe、bin/g++.exe、bin/gdb.exe三个文件 - MSYS2 用户务必用
MSYS2 MinGW64终端执行pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb,不要混用ucrt64或clang64
真正容易被忽略的是:CLion 的工具链检测依赖 g++.exe --version 输出中是否含 posix 和 seh 字样。某些第三方 MinGW-w64 打包版(尤其带 sjlj 的)会导致调试器断点失效,但编译仍成功——这种静默失败最难排查。


















