推荐从官网下载二进制包安装CMake,因其版本新、免编译、不污染系统;Ubuntu/Debian用apt安装版本过旧(如22.04仅3.22),无法支持3.27+新语法;CentOS/RHEL需启用EPEL或同样采用官网包。

Ubuntu/Debian 上用 apt 安装 cmake 最快但版本常太旧
多数发行版仓库里的 cmake 是 LTS 版本,比如 Ubuntu 22.04 自带 cmake 3.22,而当前稳定版已是 3.29+。如果你要编译较新的 C++ 项目(尤其用到 cmake_language 或 FetchContent 新特性),直接 sudo apt install cmake 很可能报错:CMake Error: The source directory "/path" does not appear to contain CMakeLists.txt——其实不是路径问题,是旧版 cmake 解析不了新版语法。
- 确认当前版本:
cmake --version - 查官方支持矩阵:CMake 3.25+ 才完整支持
find_package(... CONFIG REQUIRED)的模块缓存优化 - 若项目
CMakeLists.txt开头写了cmake_minimum_required(VERSION 3.27),就别硬扛 apt 版本了
从官网二进制包安装 cmake(推荐给非 root 用户)
不用编译、不污染系统、版本可控,适合 CI 环境或普通开发者日常使用。官网提供的 cmake-*.linux.sh 是自解压脚本,本质是预编译的静态链接二进制。
- 下载地址固定格式:
https://github.com/Kitware/CMake/releases/download/v3.29.2/cmake-3.29.2-linux-x86_64.sh(替换版本号即可) - 执行前加可执行权限:
chmod +x cmake-*.sh - 安装到用户目录(避免 sudo):
./cmake-*.sh --prefix=$HOME/cmake --skip-license - 把
$HOME/cmake/bin加进$PATH(写进~/.bashrc或~/.zshrc)
验证:which cmake 应返回 /home/xxx/cmake/bin/cmake;cmake --version 显示你指定的版本。
CentOS/RHEL 8+ 必须用 dnf + epel 或手动装,yum 不行
yum install cmake 在 RHEL 8+ 默认源里只有 cmake 3.20 左右,且 epel-release 包本身在某些最小化安装中未启用。更麻烦的是,RHEL 系统自带的 cmake3 命令其实是软链到旧版,和 cmake 冲突。
- 先启用 EPEL:
sudo dnf install epel-release -y - 再装新版:
sudo dnf install cmake --enablerepo=epel(EPEL 9 提供 cmake 3.28) - 如果仍不够新,退回「官网二进制包」方案——比从源码编译
cmake自身还省事 - 注意:
cmake3和cmake可能共存,用ls -l $(which cmake)看清实际指向
用 curl + sh 一行安装(CI 脚本常用,但得防版本漂移)
很多 GitHub Actions 或 Dockerfile 用 curl -sSL https://cmake.org/install/ | sh,这其实调用的是旧式安装脚本,已停更。正确做法是固定 URL + 校验 SHA256。
- 安全做法示例:
curl -sSL "https://github.com/Kitware/CMake/releases/download/v3.29.2/cmake-3.29.2-linux-x86_64.sh" -o cmake.sh && \ echo "2a1f...b8e7 cmake.sh" | sha256sum -c - && \ chmod +x cmake.sh && \ ./cmake.sh --prefix=/opt/cmake --skip-license
- SHA256 值必须从 GitHub Release 页面复制,不能手写——少一位就会静默失败
- CI 中建议把版本号设为变量,避免硬编码;否则某天 v3.29.3 发布后,脚本可能因校验失败卡住整个流水线
真正容易被忽略的点是:cmake 自身的 CMAKE_ROOT 和 Modules/ 路径绑定安装目录,换地方挪二进制会导致 find_package 找不到内置模块——所以别用 mv 随意移动已安装的 cmake 目录。










