答案是必须将cmake的bin目录添加到path环境变量中，否则命令行无法识别cmake命令；windows安装时需勾选“add cmake to the system path”选项，linux/macos手动解压二进制包后须编辑shell配置文件（如~/.zshrc）追加export path，且修改后需重启终端或执行source生效。
装完 CMake 不配置 PATH，cmake --version 就会报 command not found —— 这不是安装失败，是环境变量没生效。
Windows 上勾选 Add to PATH 是最省事的方案
安装 cmake-4.0.3-win64-x64.msi 时，安装向导里会出现两个 PATH 选项：
-
Add CMake to the system PATH for all users：写入系统级 PATH，所有用户都能用（需管理员权限） -
Add CMake to the system PATH for current user：只对当前用户生效，无需提权，更安全
选哪个都行，但必须勾。如果漏选，后续就得手动加：D:\Developer\CMake\bin（以你实际解压/安装路径为准）到用户或系统 PATH 中。改完要重启 CMD 或 PowerShell 才能识别新 PATH。
Linux/macOS 用二进制包时，PATH 必须自己加
官网下载的 cmake-4.0.3-Linux-x86_64.tar.gz 或 cmake-4.0.3-macos-universal.zip 是免安装包，解压后 bin/ 目录里才有 cmake 可执行文件。不加 PATH 就只能输完整路径才能运行。
常见做法是编辑 shell 配置文件：
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- bash 用户：追加
export PATH="/path/to/cmake-4.0.3-Linux-x86_64/bin:$PATH"到~/.bashrc - zsh 用户（macOS Catalina 及以后默认）：追加到
~/.zshrc
然后执行 source ~/.zshrc（或 source ~/.bashrc）立即生效。别忘了验证：cmake --version 应该输出 cmake version 4.0.3。
用包管理器安装时，PATH 通常自动处理
apt、brew、choco、winget 这类工具安装的 CMake，一般会把可执行文件放到系统标准路径（如 /usr/bin、/opt/homebrew/bin、C:\Program Files\CMake\bin），这些路径本就在系统 PATH 里，所以装完就能直接用。
但要注意例外情况：
-
sudo apt install cmake在 Ubuntu 22.04+ 默认装的是3.22.x，但老版本（如 16.04）可能只有3.5.1，不够新项目用 -
brew install cmake装的是最新稳定版，但如果你同时用pyenv或asdf管理多版本工具链，可能被它们的 shim 覆盖 PATH 顺序 -
winget install Kitware.CMake在 Windows 11 22H2+ 上表现稳定，但某些企业锁屏策略会阻止 PATH 自动写入
真正容易被忽略的点是：PATH 修改后，旧终端进程不会自动 reload。哪怕你改了 .zshrc，也得新开一个终端窗口，或者手动 source，否则 which cmake 还是找不到——这不是 CMake 的问题，是 shell 的行为惯性。
