Ubuntu下升级CMake不能依赖apt或pip，必须手动引入官方预编译二进制包或源码并显式切换入口；推荐下载cmake-X.Y.Z-linux-x86_64.sh安装至/opt/目录，再用update-alternatives注册和管理多版本。
直接升级 CMake 不能靠 apt upgrade cmake 或 pip install --upgrade cmake —— 这两种方式要么装的是 Python 包（不提供系统级 cmake 可执行文件），要么拉不到新版（Ubuntu 官源长期卡在 3.10–3.22）。必须手动引入新版本二进制或源码，并显式切换入口。
用官方预编译包替换（最快最稳）
这是绝大多数用户应首选的方式：下载已编译好的 Linux x86_64 或 aarch64 二进制包，解压后挂软链或注册到 update-alternatives。它绕过编译依赖、不污染系统包管理器、失败可秒回滚。
- 去 https://www.php.cn/link/2f387259c696ca6ee67129d6db9a35bc 找对应架构的
cmake-X.Y.Z-linux-x86_64.sh（如cmake-4.0.2-linux-x86_64.sh） - 运行安装脚本并指定路径：
sudo ./cmake-4.0.2-linux-x86_64.sh --prefix=/opt/cmake-4.0.2 - 验证安装：
/opt/cmake-4.0.2/bin/cmake --version（必须先确认这步输出正确） - 用
update-alternatives注册（推荐）：sudo update-alternatives --install /usr/bin/cmake cmake /opt/cmake-4.0.2/bin/cmake 100 - 交互切换：
sudo update-alternatives --config cmake，选编号确认
⚠️ 注意：sudo ln -sf /opt/.../cmake /usr/bin/cmake 看似简单，但会覆盖所有其他候选；一旦出错，cmake 命令直接失效，且无历史记录可查。
为什么不能 pip install cmake？
PyPI 上的 cmake 包是 Python 封装层（pyproject.toml 构建支持用的），不是系统命令行工具。它装完后 cmake --version 仍调用旧版，且 pip install cmake 生成的二进制默认放在虚拟环境内，对全局 PATH 无影响。
- 现象：
which cmake返回/usr/bin/cmake，而pip show cmake显示已安装 4.2.1 —— 两者完全无关 - 后果：CMakeLists.txt 中
cmake_minimum_required(VERSION 3.25)仍报错，因为实际执行的还是旧版 - 例外场景：仅当你用
cmake作为 Python 库调用（如import cmake）时才需要 pip 版本，但这种用法极少见
源码编译安装要防哪些坑？
源码编译适合需要调试 CMake 自身、或目标平台无预编译包（如某些 ARM 板）的情况。但它极易因缺失依赖中断，且 sudo make install 默认装到 /usr/local/bin，和 apt 安装路径冲突。
- 必装依赖：
sudo apt install build-essential libssl-dev zlib1g-dev libcurl4-openssl-dev（缺libcurl会导致bootstrap失败） - 常见错误
Failed to find "GL/gl.h"：补sudo apt install mesa-common-dev -
./bootstrap后务必检查末尾是否出现---------------------------------------------分隔线，否则后续make必失败 - 不要直接
sudo make install覆盖/usr/local/bin—— 先用--prefix=$HOME/cmake-4.0.2测试，再决定是否注册到 alternatives
真正麻烦的不是装新版本，而是让构建系统（比如 ROS、Qt Creator、VS Code CMake Tools）认出它。很多 IDE 缓存了首次扫描到的 cmake 路径，升级后需手动刷新或重启。别只验证终端里 cmake --version 成功就认为万事大吉。
