必须勾选“add cmake to the system path for all users”并安装后重启cmd验证，否则cmake命令无法全局识别；下载官方msi安装包，避免zip版，安装路径禁用中文、空格和特殊符号。
要在Windows 10上直接在CMD或PowerShell里输入cmake --version就看到版本号，必须让系统能全局识别cmake命令，这要求安装时正确写入PATH环境变量，否则每次编译都得切到bin目录下手动执行，根本谈不上跨平台编译的自动化流程。
下载官方CMake安装包
打开浏览器，访问 https://www.php.cn/link/09abb81a3bd0603d56beff274364d2de，在「Latest Release」区域找到以 cmake-X.YY.Z-windows-x86_64.msi 命名的最新版安装包（例如 cmake-3.31.8-windows-x86_64.msi），点击下载。不要选zip免安装版——它不带GUI，且手动配PATH极易出错，新手第一遍就容易卡在路径拼写或分号遗漏上。
运行MSI安装程序并勾选关键选项
双击下载好的.msi文件启动安装向导。
一路点「Next」直到出现「Install Options」页面，此时【必须勾选 “Add CMake to the system PATH for all users”】——这是让cmd全局识别cmake的唯一可靠方式。若只勾“for current user”，普通CMD窗口仍无法调用；若完全不勾，后续所有终端都需手动改PATH，等于白装。
接着勾选“Create Desktop Icon”（可选），点击Next继续。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
安装路径保持默认（如 C:\Program Files\CMake）即可，【路径中不能含中文、空格或特殊符号】，否则某些CMakeLists.txt里的绝对路径引用会静默失败，报错却找不到源头。
点击Install开始安装，等待进度条走完，最后点Finish退出。
验证命令行集成是否生效
按 Win + R 输入 cmd 回车，打开全新命令提示符窗口。
输入：cmake --version（注意是两个短横线）
回车后若立即返回类似 cmake version 3.31.8 的输出，说明安装成功且PATH已生效。如果提示“不是内部或外部命令”，请关闭所有CMD窗口，重新打开一个——环境变量变更不会自动注入已运行的进程。
