cmake --version报“command not found”根本原因是PATH未正确配置，而非未安装；需先用echo $PATH确认CMake的bin目录（如$HOME/cmake/bin或/usr/local/bin）是否在其中，再根据shell类型（bash/zsh）修改对应配置文件（~/.bashrc或~/.zshrc），执行source重载并重启终端验证。
安装失败不是“重装就完事”，而是得先分清是环境没配好、版本太旧，还是命令根本没生效。
cmake --version 报 command not found 怎么办
这不是 CMake 没装上，而是 shell 找不到它在哪。PATH 没加对、加错位置、或者终端没重载配置，是最常见原因。
- 运行
echo $PATH，确认输出里有 CMake 的bin目录（比如$HOME/cmake/bin或/usr/local/bin） - 如果路径存在但命令仍不可用，检查是否用了错误的 shell 配置文件：bash 用户改
~/.bashrc，zsh 用户得改~/.zshrc - 改完必须执行
source ~/.bashrc（或对应文件），新开终端也得 reload，VS Code 终端要重启窗口才能读新 PATH - Windows 上勾选了 “Add to PATH” 却仍报错，大概率是安装时没用管理员权限——普通用户安装后 PATH 只写入当前用户环境变量，CMD 以管理员身份启动时会走系统级 PATH，两者不一致
Linux 编译安装时提示 “CMake 3.10+ required to build CMake”
这是自举构建（bootstrapping）失败的典型表现：你用旧版 cmake 去编译新版 cmake，而新版源码里的 CMakeLists.txt 要求最低版本高于你手头这个。
- CentOS 7 默认
cmake是 2.8.12，Ubuntu 16.04 是 3.5.1，都不够编译 3.16+ 的源码包 - 别硬着头皮
./bootstrap，直接换二进制包：下载cmake-3.29.2-linux-x86_64.sh这类自解压脚本，运行./cmake-*.sh --prefix=$HOME/cmake --skip-license - 避免用
sudo make install装到/usr/local，容易和系统包冲突；装到用户目录更干净，PATH 也只影响自己 - 装完用
ls -l $(which cmake)看软链指向，确认不是残留的旧版二进制
CentOS/RHEL 上 cmake3 装了但 cmake 命令不可用
系统包管理器（如 yum）安装的 cmake3 通常不会自动创建 cmake 符号链接，PATH 里也没有 /usr/bin/cmake3 的别名。
- 先运行
type -a cmake cmake3，看是否只有cmake3可用 - 手动建软链：
sudo ln -sf /usr/bin/cmake3 /usr/bin/cmake（注意路径，不同发行版可能在/usr/bin或/usr/local/bin） - 如果系统启用了 SELinux，
ln后还得补一句sudo semanage fcontext -a -t bin_t "/usr/bin/cmake"再sudo restorecon /usr/bin/cmake，否则可能静默失败 - Docker 中的最小化镜像（如
centos:7-slim）甚至不带cmake3，得先yum install -y epel-release && yum install -y cmake3
Ubuntu/Debian apt 安装后版本不够用
Ubuntu 22.04 自带 cmake 3.22，但很多新项目要求 3.27+，cmake_minimum_required(VERSION 3.27) 一写就报错，甚至误报 “source directory does not contain CMakeLists.txt”。
-
apt install cmake装的是仓库版本，更新慢、滞后严重；别信which cmake，一定要跑cmake --version确认真实版本 - 推荐用官网二进制包替代 apt：下载
cmake-3.29.2-linux-x86_64.sh，执行chmod +x后安装到$HOME/cmake，再把$HOME/cmake/bin加进 PATH - 不要用已停更的安装脚本：
curl -sSL https://cmake.org/install/ | sh可能拉到过期或不可信内容 - 多个版本共存时，
type -a cmake会列出所有路径，优先级由 PATH 顺序决定；想临时切版本，可用完整路径调用，比如$HOME/cmake/bin/cmake --version
最常被忽略的点是：你以为装好了，其实 shell 根本没加载新 PATH；你以为版本够了，其实 cmake --version 显示的是旧版残留；你以为是项目问题，其实是构建工具本身卡在了自举环节。
