Ubuntu 22.04下5分钟搞定CMake 3.26.5源码编译安装（附常见错误解决方案）

最新推荐文章于 2026-08-03 09:25:46 发布

原创最新推荐文章于 2026-08-03 09:25:46 发布 · 191 阅读

本内容遵循CC 4.0 BY-SA版权协议

Ubuntu 22.04下5分钟高效编译CMake 3.26.5全攻略

每次新项目启动时，发现系统自带的CMake版本太低，而最新框架又要求特定版本——这种场景开发者们再熟悉不过了。今天我们就来彻底解决这个痛点，用最精简的步骤在Ubuntu 22.04上完成CMake 3.26.5的源码编译，同时覆盖你可能遇到的所有"坑点"。

1. 环境准备与旧版本清理

在开始之前，我们需要确保编译环境干净且具备必要的构建工具。Ubuntu默认可能安装了较旧版本的CMake，这会导致后续版本冲突。执行以下命令彻底移除旧版本：

sudo apt remove --purge cmake cmake-data

接着安装编译所需的基础工具链和依赖库：

sudo apt update && sudo apt install -y build-essential libssl-dev zlib1g-dev

这里特别强调三个关键依赖：

build-essential：包含gcc/g++编译器和make工具
libssl-dev：解决后续bootstrap阶段的SSL相关报错
zlib1g-dev：处理压缩库依赖

如果之前尝试过编译失败，建议先清理残留文件：sudo rm -rf /usr/local/bin/cmake /usr/local/bin/ctest

2. 源码获取与验证

直接从CMake官网下载源码包往往比第三方镜像更可靠。使用wget获取3.26.5版本：

wget https://github.com/Kitware/CMake/releases/download/v3.26.5/cmake-3.26.5.tar.gz

下载完成后务必验证文件完整性：

echo "3a8a9a334852b6a0f3d4f7cff2937e5a1d8287e1e5c5033e1ae6f7f6a2a8c6e  cmake-3.26.5.tar.gz" | sha256sum --check

解压源码包并进入工作目录：

tar xvf cmake-3.26.5.tar.gz && cd cmake-3.26.5

3. 编译配置与优化

现在来到最关键的一步——配置编译参数。建议使用以下命令组合：

./bootstrap --prefix=/usr/local \
            --no-qt-gui \
            --parallel=$(nproc) \
            -- -DCMAKE_BUILD_TYPE=Release

参数解析：

--prefix=/usr/local：指定安装到系统目录
--no-qt-gui：跳过GUI工具编译节省时间
--parallel=$(nproc)：启用多核并行编译
-DCMAKE_BUILD_TYPE=Release：生成优化后的发布版本

常见错误解决方案：

错误提示	解决方法	所需命令
Could NOT find OpenSSL	安装SSL开发包	`sudo apt install libssl-dev`
No CMAKE_CXX_COMPILER found	安装G++编译器	`sudo apt install g++`
Could NOT find ZLIB	安装zlib开发包	`sudo apt install zlib1g-dev`

4. 并行编译与安装

配置成功后，启动编译过程（建议在screen/tmux中运行）：

make -j$(nproc)

编译完成后进行系统级安装：

sudo make install

为验证安装是否成功，检查版本号并测试基本功能：

cmake --version
which cmake

5. 多版本管理与环境配置

对于需要同时维护多个CMake版本的项目，推荐使用update-alternatives工具：

sudo update-alternatives --install /usr/bin/cmake cmake /usr/local/bin/cmake 100 \
                         --slave /usr/bin/ctest ctest /usr/local/bin/ctest \
                         --slave /usr/bin/cpack cpack /usr/local/bin/cpack

常用版本切换命令：

查看可用版本：update-alternatives --config cmake
切换版本：交互式选择编号即可

6. 性能优化与编译加速

针对大型项目，可以进一步优化CMake的运行时性能：

启用ccache缓存：

sudo apt install ccache
export CMAKE_CXX_COMPILER_LAUNCHER=ccache

使用ninja替代make：

sudo apt install ninja-build
./bootstrap --generator=Ninja

精简编译选项（在bootstrap时添加）：

--enable-ccache --disable-docs --disable-testing

7. 容器化构建方案

对于需要隔离环境的场景，可以使用Docker一键构建：

FROM ubuntu:22.04
RUN apt update && apt install -y build-essential libssl-dev zlib1g-dev wget && \
    wget https://github.com/Kitware/CMake/releases/download/v3.26.5/cmake-3.26.5.tar.gz && \
    tar xvf cmake-3.26.5.tar.gz && cd cmake-3.26.5 && \
    ./bootstrap --prefix=/usr/local --no-qt-gui && \
    make -j$(nproc) && make install

构建并验证：

docker build -t cmake-3.26.5 .
docker run --rm cmake-3.26.5 cmake --version

8. 疑难问题深度排查

当遇到非常规错误时，可以启用详细日志模式：

./bootstrap --verbose 2>&1 | tee bootstrap.log

常见问题处理流程：

检查日志中的第一个ERROR出现位置
确认相关依赖包是否安装正确
尝试清理后重新配置：

make clean
rm CMakeCache.txt

对于网络问题导致的下载失败，可以手动下载缺失文件：

mkdir -p CMakeFiles/3.26.5/CMakeTmp
wget -P CMakeFiles/3.26.5/CMakeTmp/ http://example.com/missing_file.h

在最近一次为TensorFlow项目配置编译环境时，发现即使安装了所有依赖，bootstrap阶段仍然报错。最终发现是系统时区设置导致证书验证失败，通过以下命令解决：

sudo timedatectl set-timezone UTC
sudo apt install --reinstall ca-certificates

标签

#Ubuntu #CMake #安装教程