CLion中CMake配置失败90%源于路径、版本或项目结构问题：需确保cmake在PATH中且≥3.15，CMakeLists.txt位于File|Open所选根目录顶层，工具链路径真实存在，修改后手动Reload项目。
CLion 里 CMake 配置失败，90% 是路径、版本或项目结构没对上，不是配置逻辑错了，而是环境没搭好。
CLion 找不到 cmake 可执行文件？先确认 PATH 和版本
CLion 启动时只查系统 PATH，不读注册表、不猜安装位置。如果 Settings → Build → CMake 里 CMake executable 下拉框为空，说明它根本没看见 cmake。
- Windows：命令提示符运行
cmake --version，报“不是内部或外部命令” → 重装 CMake 并勾选 Add to PATH，或手动把C:\Program Files\CMake\bin加进系统环境变量 - macOS/Linux：终端运行
which cmake，返回空 → 检查~/.zshrc或~/.bash_profile里是否漏加了export PATH="/path/to/cmake/bin:$PATH" - 版本必须 ≥ 3.15：CLion 对自定义 CMake 有硬性要求，
find_package(Qt6)、target_link_libraries( PRIVATE )等语法在 3.14 及以下会静默失败；用cmake --version确认，Ubuntu 用户慎用apt install cmake（默认是 3.10），推荐sudo apt install cmake && sudo apt-add-repository ppa:george-edison55/cmake-3.x && sudo apt update && sudo apt install cmake
CMakeLists.txt 改了但没生效？别等自动 reload
CLion 不监听文件变更实时重配置。改完 CMakeLists.txt 后，编辑器里 add_executable 还标红、Run 配置没更新，大概率是 CMake 没重跑。
- 右下角出现黄色提示条 Reload CMake project → 点它（这是最直接的触发方式）
- 关闭 Automatically reload CMake project on changes（Settings → Build → CMake）→ 避免因防病毒软件/NFS 挂载导致监听失效后误以为“自动生效了”
- 手动触发：CMake 工具窗口（View → Tool Windows → CMake）点刷新图标，或右键项目根目录 → Reload project
运行按钮灰色 / “No CMakeLists.txt found”？检查项目根目录和文件位置
CLion 默认只认你通过 File | Open 选中的那个文件夹顶层的 CMakeLists.txt。放错一层，整个项目就“失联”。
- 错误现象：
CMake工具窗口显示 No CMakeLists.txt found、所有 CMake 指令标红、#include <iostream>报错、Run 按钮灰显 - 典型错误路径：
my_project/src/CMakeLists.txt（CLion 不认）、my_project/build/CMakeLists.txt（更不行） - 正确做法：确保
CMakeLists.txt在my_project/目录下，然后 File | Close Project → File | Open → 选中 my_project 文件夹（不要选它的父目录，也不要选子目录） - 多配置支持仅限
CMakePresets.json（2024.2+），旧版 CLion 仍只处理一个根目录下的CMakeLists.txt
configure 失败报 “Compiler not found” 或 “Toolset not found”？工具链路径必须真实存在
CLion 不依赖 PATH 查编译器，它只认 Settings → Toolchains 里填的绝对路径。哪怕 gcc 在终端能跑，这里路径不对照样失败。
- MinGW：实际路径通常是
C:\mingw64\bin\gcc.exe，不是C:\mingw64\mingw64\bin\gcc.exe（安装器前缀可能多一层） - Qt 自带 MinGW：路径是
C:\Qt\Tools\mingw11_64\bin\g++.exe，别错选成mingw11_32 - MSVC：必须选对 Visual Studio 版本（如
Visual Studio 2022），且确认已安装 Desktop development with C++ 工作负载；报v143not found 就说明 VS 安装不全 - 验证方式：Settings → Toolchains → 点击编译器路径右侧的文件夹图标 → 确保能打开对应目录，并看到
gcc.exe或cl.exe
最容易被忽略的是：CMake 缓存（CMakeCache.txt）会固化第一次配置时的路径和工具链信息。项目移动、重命名或切换编译器后，不删构建目录就重开 CLion，常会触发 CMakeCache.txt directory is different than the directory where it was created 这类错误——这时候清掉 cmake-build-* 文件夹比调设置更有效。
