CLion启动时提示“Cannot find CMake”说明系统PATH中未找到cmake可执行文件;需在终端运行cmake --version验证,若失败则重装CMake并勾选“Add to PATH”(Windows)或修正~/.zshrc中的PATH(macOS/Linux),Linux用户还需确保版本≥3.15。

CLion 启动时提示 Cannot find CMake,说明它根本没在系统里找到可执行的 cmake 命令——不是配置错了,是压根没看见。
检查终端能否直接运行 cmake --version
这是第一道硬门槛。CLion 不查注册表、不读安装日志,只认 PATH 里的 cmake 可执行文件。
- Windows:打开命令提示符或 PowerShell,输入
cmake --version。如果报“不是内部或外部命令”,说明没进 PATH ——重装 CMake 时必须勾选 Add CMake to the system PATH;若已装,手动把C:\Program Files\CMake\bin(或你实际安装路径)加到系统环境变量 PATH 中 - macOS:终端运行
which cmake。返回空?说明 Homebrew 安装后没生效,检查~/.zshrc是否包含export PATH="/opt/homebrew/bin:$PATH"(Apple Silicon)或/usr/local/bin(Intel) - Linux(Ubuntu/Debian):运行
cmake --version。若版本 ≤ 3.10(apt install cmake默认装的),CLion 2023.3+ 会拒绝使用——改用sudo snap install cmake --classic或从 cmake.org 下载二进制包并加入 PATH
CLion 设置里 CMake executable 下拉框为空
这表示 CLion 没从 PATH 自动探测到任何 cmake,但不代表不能救。
- 别点“Download and Install”,那个按钮只下载旧版(3.25 左右),且不保证和你的工具链兼容
- 直接点右侧文件夹图标,手动定位到你确认可用的
cmake:Windows 是cmake.exe,macOS/Linux 是cmake(不是cmake-gui) - 选完后看 Settings 页面是否显示完整路径,再点
Apply。此时 CLion 会立即尝试调用该路径下的cmake --version验证有效性
CLion 找得到 cmake 却报 “version 3.15 required”
这不是找不到,是版本太低。CLion 内部解析 find_package(Qt6)、target_link_libraries( PRIVATE ) 等现代语法时,硬性依赖 ≥ 3.15 的 CMake 版本。
- 在 Settings > Build > CMake 页面,看
CMake executable显示的路径,然后终端里跑一遍/path/to/your/cmake --version确认真实版本 - Ubuntu 用户注意:
sudo apt install cmake通常只给 3.10,得加 PPA:sudo apt install software-properties-common && sudo add-apt-repository ppa:george-edison55/cmake-3.x && sudo apt update && sudo apt install cmake - macOS 用户:
brew upgrade cmake即可,Homebrew 默认维护最新稳定版
真正卡住人的地方,往往不是“怎么配”,而是误以为 CLion 能自己猜路径、自己升级、自己修 ABI。它只做一件事:调用你 PATH 里那个 cmake,然后严格按 CMakeLists.txt 执行。路径、版本、权限,三者缺一不可。











