CMake项目未加载主因是CMakeLists.txt不在File|Open所选目录顶层或Toolchains中编译器路径错误；CLion仅识别项目根目录下CMakeLists.txt，且直接读取设置中填的绝对路径而非系统PATH。
CMake 项目没加载，八成是 CMakeLists.txt 没放对位置，或编译器路径填错了——不是 CLion 抽风，是它根本没启动 CMake 配置流程。
CLion 找不到 CMakeLists.txt 的真实原因
CLion 不会递归扫描子目录找配置文件。它只认你通过 File | Open 打开的那个文件夹顶层的 CMakeLists.txt。哪怕你把文件放在 src/CMakeLists.txt 或 build/CMakeLists.txt，它都直接无视。
- 现象：CMake 工具窗口显示
No CMakeLists.txt found，所有find_package、add_executable全部标红，头文件跳转失效 - 错误操作：用
Add Content Root把子目录硬加进项目——这不会触发 CMake 加载，纯属白忙 - 正确做法：关掉当前项目 →
File | Open→ 选中包含CMakeLists.txt的那个文件夹（必须是它的父目录） - 多配置支持？2024.2+ 版本只认
CMakePresets.json，旧版仍只看根目录下唯一的CMakeLists.txt
Compiler not found 不是环境变量问题，是路径填错了
CLion 在 Settings | Build, Execution, Deployment | Toolchains 里填的路径，它会直接去读取，不查系统 PATH。哪怕你命令行能跑 g++ --version，只要这里指向的目录里没有 g++.exe，configure 就卡死。
- MinGW-w64 常见错路径：
C:\mingw64\mingw64\bin\g++.exe（多了一层mingw64）→ 正确应为C:\mingw64\bin\g++.exe - Qt 自带 MinGW？路径通常是
C:\Qt\Tools\mingw11_64\bin\g++.exe，别手抖选成mingw11_32 - MSVC 工具链必须匹配已安装的 Visual Studio 版本，并确认勾选了
Desktop development with C++工作负载 - 检查方式：在 CLion 的 CMake Output 窗口第一行，如果看到
Could not find compiler set in environment variable CC或类似提示，立刻回头核对 Toolchains 里的绝对路径
改了 CMakeLists.txt 却没反应？重载没触发
CLion 默认开启自动重载，但实际常因防病毒软件拦截、NFS 挂载延迟或文件监听失效而“静音”。加了 find_package(OpenCV REQUIRED) 却看不到新 target，大概率是 configure 根本没跑。
- 手动触发：右键
CMakeLists.txt→Reload project，或点 CMake 工具窗口顶部的刷新图标 - 临时关闭自动重载：设置里关掉
Automatically reload CMake project on changes，避免误判 - 缓存干扰？菜单栏
Tools | CMake | Reset cache and reload project，比清.idea或 Invalidate Caches 更精准 - 注意：修改后若 CMake Output 窗口无任何输出，说明连 configure 阶段都没进入，优先查前两个问题
最容易被忽略的是：CLion 的 CMake 配置只对整个项目生效，对单个 .cpp 文件右键运行是无效的——它不会读 target_include_directories，也不会链接你声明的库，报 undefined reference 或头文件找不到都是必然结果。运行前务必确认 Run Configuration 里选的是 target（比如 app），而不是某个孤立的源文件。
