CLion在Windows上必须配置MinGW工具链才能编译C/C++代码；默认捆绑MinGW-w64 13.1开箱可用，但若项目有版本、线程或异常处理要求，需手动指定根目录路径（如C:\mingw64），CLion不读系统PATH，且严格校验bin/下gcc.exe、g++.exe、gdb.exe存在，路径须无中文空格，MSYS2正确路径为D:\msys64\mingw64（非\bin），Debugger推荐使用内置Bundled GDB以支持STL渲染，多版本切换需独立安装并绑定项目级Toolchain，同时修改TEMP/TMP环境变量为英文路径以防CMake构建失败。
CLion 在 Windows 上无法直接编译 C/C++ 代码，必须显式配置 MinGW 工具链；默认捆绑的 Bundled MinGW（MinGW-w64 13.1）开箱可用，但若项目有版本、线程模型或异常处理要求，就必须手动指定路径——不是加环境变量就能用，CLion 不读系统 PATH 里的 gcc。
为什么 CLion 找不到你装好的 MinGW
常见错误现象：Toolchain is not configured、Cannot find compiler、点击 Auto-detect 后列表为空。根本原因不是没装对，而是 CLion 只扫描特定目录结构，并且严格校验 bin/ 下是否存在 gcc.exe、g++.exe、gdb.exe 三个可执行文件。
- 解压版 MinGW-w64 必须放在无中文、无空格路径下（如
C:\mingw64），否则检测失败 - 使用 MinGW 安装器（
mingw-w64-install.exe）时，若只勾选了mingw32-gcc-g++，缺mingw32-gdb，CLion 会拒绝识别该工具链 - MSYS2 安装的
mingw64环境不能直接填D:\msys64\mingw64—— 正确路径是D:\msys64\mingw64\bin，但 CLion 要求的是根目录（即D:\msys64\mingw64），它自己会拼bin/ - CLion 2024.2+ 对 SEH 异常处理更友好，若你用的是旧版 SJLJ 构建的 MinGW，调试时可能卡在断点或崩溃，这不是配置失败，是 ABI 不兼容
如何在 Settings 中正确添加 MinGW 工具链
路径： File → Settings → Build, Execution, Deployment → Toolchains，点击 + → 选 MinGW。
-
Toolset字段填 MinGW 根目录（不是bin/！例如C:\mingw64或D:\msys64\mingw64） - CLion 会自动补全
gcc、g++、gdb路径；若某一项显示红叉，鼠标悬停看提示，大概率是文件缺失或权限被拦截 -
Debugger建议优先选Bundled GDB（路径在CLion\bin\gdb\win\x64\bin\gdb.exe），它内置 Python 支持，能正常渲染 STL 容器；自定义 GDB 若没编译 Python 模块，std::vector在 Debug 视图里只显示地址 - 不要勾选
Use conda or virtual environment—— 这是给 Python 项目用的，和 MinGW 无关
多版本 MinGW 切换的关键操作点
不同项目需要不同 GCC 版本（比如 GCC 8.1 兼容旧驱动，GCC 12.2 支持 std::format），靠改系统环境变量行不通，CLion 的解决方案是「项目级绑定」。
- 每个 MinGW 版本必须独立安装到不同目录（如
C:\mingw\gcc810、C:\mingw\gcc122），严禁覆盖安装 - 在项目
CMakeLists.txt顶部加两行强制指定编译器（防止 CMake 自动嗅探系统 PATH）：set(CMAKE_C_COMPILER "C:/mingw/gcc810/bin/gcc.exe")<br>set(CMAKE_CXX_COMPILER "C:/mingw/gcc810/bin/g++.exe")
- CLion 的
Toolchains设置支持多个条目，但当前项目只生效「Project toolchain」下拉框所选的那个——这个下拉框在 Settings 页面右上角，不是主列表里的「Default」 - 切换后务必点击右上角
Reload CMake project（锤子图标），否则 CMake 缓存仍用旧编译器
最易被忽略的是临时目录路径：如果 Windows 用户名含中文（如 C:\Users\张三\AppData\Local\Temp），CMake 生成的 Ninja 构建脚本会因路径编码失败而报错 Failed to run MSBuild command 或 invalid argument。必须把系统环境变量 TEMP 和 TMP 改为纯英文路径（如 C:\temp），并重启 CLion。
