能直接运行 cmake --version 并输出版本号，就说明安装成功了；否则根本原因是 path 未正确配置，常见于安装时未勾选“add cmake to the system path”、未重启终端、路径填写错误、多版本冲突或包管理器未刷新环境。
能直接运行 cmake --version 并输出版本号，就说明安装成功了——这是唯一需要确认的核心事实。
执行 cmake --version 报“不是内部或外部命令”
这表示系统找不到 cmake.exe，根本原因几乎全是 PATH 没配好。
- 安装时没勾选
Add CMake to the system PATH for current user或for all users（.msi 安装器里那个复选框） - 勾选了但没重启终端：CMD/PowerShell 启动时读取的是旧的环境变量快照，必须新开一个窗口
- 手动添加过 PATH 但路径写错：比如填成
C:\Program Files\CMake\bin\，实际安装目录可能是C:\Program Files\CMake\（少了一级bin） - 用的是 scoop/chocolatey 等包管理器安装，但没运行
scoop shell或没刷新 shell 环境
cmake --version 有输出，但版本太旧或不是预期版本
说明系统里存在多个 CMake 实例，当前生效的是低优先级的那个。
- 旧版残留：比如之前用 zip 包解压到某目录并加进 PATH，新版 msi 安装后没删旧路径
- IDE 自带 CMake：VS Code 的 CMake Tools 插件、CLion、Visual Studio 都可能自带或指定独立 CMake 路径，它们不走系统 PATH
- PATH 中多个路径都含
cmake.exe，Windows 按顺序扫描，排在前面的先被命中。用where cmake查看实际加载的是哪个
GUI 能打开，但命令行不行
CMake GUI 是独立可执行文件（cmake-gui.exe），它不依赖 PATH，所以能打开 ≠ 命令行可用。
- GUI 安装包默认不修改 PATH，只放快捷方式，属于常见误导点
- 验证必须用命令行：哪怕只输
cmake（不带参数），看到 help 文本也算通过；但最可靠仍是cmake --version - 某些企业镜像源或离线安装包会把
cmake.exe和cmake-gui.exe分开放，GUI 目录下未必有命令行工具
真正容易被忽略的是：PATH 配对后，**必须新开终端**，且 where cmake 比 cmake --version 更早暴露多版本冲突问题。
