cmake --version 是唯一可靠验证方式，因为它不依赖项目、CMakeLists.txt 或构建目录，仅检验可执行文件是否被系统识别；GUI 可用不代表命令行可用，而自动化流程只认命令行入口。
直接运行 cmake --version，能输出版本号就说明安装和 PATH 配置都成功了；如果报“命令未找到”，问题一定出在环境变量没生效或没加对。
为什么 cmake --version 是唯一可靠验证方式
它不依赖项目、不依赖 CMakeLists.txt、不依赖构建目录，只检验可执行文件是否被系统识别。很多新手误以为“能进 CMake GUI 就算装好了”，但 GUI 启动不等于命令行可用——而绝大多数自动化流程（CI、脚本、IDE 构建插件）只认命令行入口。
- Windows 上装 .msi 时漏选
Add CMake to the system PATH，CMD/PowerShell 就找不到cmake - Linux/macOS 用源码编译安装，默认路径常是
/usr/local/bin/cmake，但该路径未必在$PATH里 - 即使装了，新开的终端也不会自动继承旧 shell 的 PATH 变更，必须重启终端或手动
source ~/.bashrc
常见错误现象和对应排查动作
看到 'cmake' is not recognized as an internal or external command（Windows）或 command not found: cmake（Linux/macOS），别急着重装，先做这三件事：
- 运行
where cmake（Windows）或which cmake（Linux/macOS）——如果无输出，说明确实没加进 PATH - 检查安装路径是否存在：Windows 默认在
C:\Program Files\CMake\bin，Linux 源码安装多在/usr/local/bin，macOS Homebrew 装在/opt/homebrew/bin - 确认 PATH 是否包含该路径：
echo $PATH（Linux/macOS）或echo %PATH%（Windows），看输出里有没有对应目录
cmake --version 成功但后续构建失败？注意这几点
版本号能打出，不代表所有功能可用。尤其当你用到较新语法（比如 find_package(... REQUIRED) 或 target_link_libraries(... PRIVATE)）时，旧版 CMake 会静默忽略或报错。
- 最低版本要求常写在项目
CMakeLists.txt第一行：cmake_minimum_required(VERSION 3.16)，你本地版本低于它就会失败 - Ubuntu 官方源的
cmake包往往陈旧（如 3.10），建议用apt install cmake-data+ 手动下载新版二进制，或用pipx install cmake - Windows 上同时装了多个版本（比如 VS 自带的、Chocolatey 装的、官网 MSI 装的），
cmake --version显示的可能是优先级更高的那个，不一定是你想用的
真正麻烦的不是装不上，而是装上了却用不对版本——尤其当多个工具链共存时，PATH 顺序、shell 初始化逻辑、IDE 内置 CMake 路径设置，都会悄悄覆盖你的预期。动手前先搞清「谁在调用哪个 cmake」，比反复重装更省时间。
