CLion 本身不带编译器，必须显式配置 GCC 工具链（gcc.exe/g++.exe），否则新建项目会提示“Toolchain not configured”或报错“Cannot find compiler 'gcc'”；常见原因包括多版本 MinGW 冲突、架构/线程模型不匹配、PATH 混乱、杀毒软件拦截、路径含空格或中文、未重载 CMake 项目等。
CLion 本身不带编译器，必须显式配置 GCC 工具链（即 gcc.exe 和 g++.exe），否则新建项目会卡在“Toolchain not configured”或构建时报错 Cannot find compiler 'gcc'。
CLion 找不到 gcc.exe 的常见原因
不是路径写错，就是环境没隔离清楚——尤其当你装了多个 MinGW 版本、或同时有 VS 和 MinGW 时，CLion 容易自动选错。
- 系统
PATH里混着不同版本的bin目录（比如C:\mingw810\bin和C:\mingw1120\bin同时在 PATH），CLion 检测时可能随机挑一个，但那个目录下偏偏缺g++.exe或权限受限 - 你下载的是 MinGW-w64 官方安装器，但勾选了
i686（32位）架构，而 CLion 默认期望x86_64；或者选了win32线程模型，但项目用了std::thread导致链接失败 - CLion 捆绑的 MinGW（
Bundled MinGW）默认是posix-seh，但你手动指定路径时指向了自己解压的win32-sjlj版本，结果调试器（gdb.exe）无法启动，报错Failed to start gdb - Windows Defender 或杀毒软件把刚下载的
gcc.exe误判为风险程序并静默隔离，表面路径存在，实际执行被拦截
手动指定 MinGW 工具链路径的实操要点
别依赖“自动检测”，直接填绝对路径更稳。重点核对三个文件是否存在且可执行：
-
gcc.exe和g++.exe必须在同一级bin/目录下（例如C:\mingw1120\bin\gcc.exe） -
gdb.exe建议用 CLion 捆绑的（路径类似clion-2026.2\bin\gdb\windows\gdb.exe），避免自建 MinGW 的 GDB 缺 Python 支持，导致断点不生效 - 如果用自定义 MinGW，确保其
bin/目录**没有空格和中文**（如C:\Program Files\mingw\bin会失败；D:\mingw64\bin安全） - 在 CLion 的
File | Settings | Build, Execution, Deployment | Toolchains里点击+→ 选MinGW→ 在Environment下拉框选System→ 然后手动填Compiler path为gcc.exe的完整路径（不是目录！）
多 GCC 版本切换时 CMakeLists.txt 要同步改
光在 Toolchain 里切版本不够——CMake 缓存会记住上一次用的编译器。不清理就换，大概率触发 CMake Error: The source directory does not contain CMakeLists.txt 或静默使用旧版本。
立即学习“C++免费学习笔记（深入）”；
- 每次切换工具链后，必须点击 CLion 右上角
Reload CMake project（小刷新图标），或手动删掉cmake-build-*目录再重载 - 若项目明确要求 GCC 11+，在
CMakeLists.txt开头加：set(CMAKE_CXX_STANDARD 17)和set(CMAKE_CXX_STANDARD_REQUIRED ON)，否则即使工具链是 GCC 11，CMake 仍可能降级到 C++14 - 想验证当前实际调用的编译器版本，可在
CMakeLists.txt里加一句：message(STATUS "Using compiler: ${CMAKE_CXX_COMPILER_ID} ${CMAKE_CXX_COMPILER_VERSION}")，构建日志里就能看到输出
最常被忽略的一点：CLion 的 Toolchain 配置是**项目级**的，不是全局设置。新建项目时它会重新走一遍自动检测逻辑，哪怕你刚在一个项目里配好了 GCC 11.2 —— 所以每个项目首次打开都要检查右下角是否弹出 Toolchain not configured 提示，别习惯性点跳过。
