CLion自动检测PATH中的CMake，若报错则需检查PATH配置、版本是否≥3.15及CMakeLists.txt修改后手动reload；install目标需显式声明install()命令。
直接用就行，不用额外配置——只要 CMake 可执行文件在系统 PATH 里，CLion 启动时会自动检测并使用它。如果 CLion 报错找不到 cmake，那问题一定出在路径或版本上，不是“怎么配”，而是“没找着”或“太旧了”。
CLion 找不到 cmake 命令？检查这三处
CLion 不依赖你手动指定 cmake 路径，它默认查 PATH；但很多人装完 CMake 没勾选“Add to PATH”，导致 CLion 看不见。
- Windows：打开命令提示符，运行
cmake --version。如果报“不是内部或外部命令”，说明没进PATH——重装 CMake 并勾选“Add CMake to the system PATH”，或手动把安装目录（如C:\Program Files\CMake\bin）加到系统环境变量。 - macOS/Linux：终端运行
which cmake。返回空？说明没装对或没生效。Homebrew 安装后通常没问题；若用官网 pkg 或 tar.gz，记得把bin/目录加进~/.zshrc或~/.bash_profile里的PATH。 - CLion 内部验证：进入 Settings | Build, Execution, Deployment | CMake，看 “CMake executable” 下拉框里有没有自动列出路径。如果没有，点右侧的文件夹图标手动选
cmake可执行文件（别选cmake-gui）。
为什么 CMake 配置失败，报 “version 3.15 required”？
CLion 自带的 bundled CMake 版本是 3.26+，但如果你在 Settings 里手动切换成自定义 CMake，又用了老版本（比如 Ubuntu 默认的 3.10），就会卡在 cmake_minimum_required(VERSION 3.15) 这一行。
- 检查你用的是哪个 CMake：在 Settings 的 CMake 页面，看 “CMake executable” 显示的路径，再终端里跑一遍
path/to/your/cmake --version确认版本。 - CLion 明确要求自定义 CMake ≥ 3.15。低于这个版本，
find_package(Qt6 ...)、target_link_libraries(... PRIVATE)等现代写法会直接解析失败，不报具体错误，只显示“configure failed”。 - 解决办法很简单：升级 CMake。Ubuntu 用户用
sudo apt install cmake通常不够，得加 PPA 或下载二进制包；macOS 用户brew upgrade cmake即可。
CLion 中修改 CMakeLists.txt 后不生效？别等自动 reload
CLion 不是实时监听 CMakeLists.txt 变更并重 configure —— 它只在特定时机触发，比如项目打开、手动点击 reload 按钮，或你改了 CMake 设置。
- 改完
CMakeLists.txt后，右下角会出现黄色提示条 “Reload CMake project”，点它；或者按快捷键Ctrl+Shift+O（Windows/Linux）或Cmd+Shift+O（macOS）强制 reload。 - 如果点了没反应，看 CMake 工具窗口（
View | Tool Windows | CMake）里有没有报错。常见坑是：find_package(Qt5Widgets REQUIRED)但CMAKE_PREFIX_PATH指向了 Qt6 安装路径，或者路径里有中文/空格没加引号。 - 注意：修改
CMAKE_BUILD_TYPE或CMAKE_INSTALL_PREFIX这类缓存变量，必须先clean再 reload，否则旧值仍被缓存。可以在 CMake 工具窗口点 “Delete cache and reload project”。
install 目标不出现？是因为没写 install() 命令
CLion 的 “Build | Install” 菜单项，只在 CMakeLists.txt 里显式声明了 install() 命令后才可用。它不会自动为你生成安装逻辑。
- 最简 install 示例：
install(TARGETS myapp DESTINATION bin)—— 这会让myapp可执行文件被复制到<cmake_install_prefix>/bin</cmake_install_prefix>下。 -
DESTINATION是相对路径，实际安装位置 =CMAKE_INSTALL_PREFIX+DESTINATION。默认CMAKE_INSTALL_PREFIX是/usr/local（Linux/macOS）或C:/Program Files/${PROJECT_NAME}（Windows），你可以在 Settings 的 CMake 页面里改。 - 想以 root 权限安装？不要勾 “以 root 权限运行” —— 那只是给你的程序加权限，不是给 install 命令。正确做法是：创建一个 CMake Target 配置，把 “Build target” 设为
install，然后在运行配置里启用 “以 root 权限运行”。
最容易被忽略的其实是 CMake 缓存的顽固性：改了 set(CMAKE_CXX_STANDARD 20) 却没 reload，或者删了 add_executable() 但没 clean cache，CLion 仍会用旧配置构建。动手前先看 CMake 工具窗口的输出，比猜强得多。
