clion 启动后找不到 mingw 编译器,因其默认不带编译器,需单独安装 mingw-w64(如 x86_64-posix-seh)并解压至纯英文路径(如 c:\mingw64),在 settings → toolchains 中手动指定 bin 目录;同时须修改系统 temp/tmp 为英文路径、指定独立 cmake 路径,并避免项目模板误选 windows application。

CLion 启动后找不到 MinGW 编译器
不是 CLion 没装好,而是它默认不带编译器 —— MinGW 需要你单独安装并显式告知路径。CLion 启动时若没检测到可用工具链,会卡在 “No toolchain configured” 或显示红色感叹号,点 more 常见报错是 CMake not found 或 Compiler not found,根源往往不是编译器本身,而是路径或环境变量干扰。
- 先确认你装的是
MinGW-w64(不是老版MinGW),推荐下载离线包如x86_64-posix-seh,解压到纯英文路径,例如C:\mingw64 - 不要把
MinGW装在带中文、空格或括号的路径下(比如C:\Program Files\或C:\Users\张三\),否则 CLion 的 CMake 会静默失败 - 暂不建议直接修改系统
PATH;CLion 支持项目级工具链绑定,全局污染反而容易引发多版本冲突
在 Settings → Toolchains 中正确添加 MinGW
进入 File > Settings > Build, Execution, Deployment > Toolchains,点击 + → MinGW,关键操作不是“选中”,而是“验证”。CLion 会自动扫描常见路径,但经常漏掉你解压的位置。
- 手动填入
MinGW的bin目录:比如C:\mingw64\bin(注意不是C:\mingw64根目录) -
Debugger推荐用 CLion 捆绑的GDB(路径类似CLion2024.2.2\bin\gdb\win\x64\bin\gdb.exe),它内置 Python 渲染支持,自建MinGW里的gdb.exe很可能缺这个 - 如果编译器字段仍显示
Not found,鼠标悬停看 tooltip —— 常见原因是gcc.exe或g++.exe文件缺失,检查你解压的bin目录下是否存在这两个文件
为什么 CMake 报错 “Path contains non-ASCII characters”
这个错误和用户名含中文强相关,哪怕你 MinGW 路径是干净的,CLion 默认缓存目录(C:\Users\你的中文名\.CLion2024.2\system\cmake\)和系统临时目录(%TEMP%)也会触发 CMake 拒绝启动。
- 改系统环境变量
TEMP和TMP为纯英文路径,例如C:\temp(需新建该文件夹) - 在 CLion 的
Toolchains设置页,手动指定一个干净的CMake:下载官方二进制版cmake-3.28.3-windows-x86_64.msi,装到C:\CMake\,然后在CMake字段填C:\CMake\bin\cmake.exe - 重启 CLion,别跳过 “Reload project” 提示 —— 旧缓存不清理,新配置不生效
验证是否真能编译,而不是只通过界面检测
界面上显示绿色勾 ≠ 能真正构建。很多用户卡在 “HelloWorld.cpp 编译失败:undefined reference to `WinMain@16`”,这是链接器误判 GUI 子系统导致的,和工具链配置无关,但会让人误以为 MinGW 没配好。
- 新建项目时选
C++ Executable,**不要选Windows Application**(后者强制 GUI 模式) - 确保
CMakeLists.txt里有set(CMAKE_CXX_STANDARD 17),且add_executable的 target 名不含空格或特殊字符 - 第一次构建前,右键项目根目录 →
Reload CMake project,观察底部Build窗口输出:出现[100%] Built target xxx才算闭环











