cmake安装后验证需先执行cmake --version命令，若返回版本号则说明安装成功且path生效；若提示“命令未找到”，则需检查环境变量配置是否正确，尤其确认安装路径是否已加入系统path。
装完就能用，但得确认 cmake 命令真在系统 PATH 里——这是绝大多数“命令未找到”问题的根源。
怎么验证 cmake 是否可用
别急着跑项目，先终端里敲：
cmake --version
如果返回类似 cmake version 3.22.1，说明安装成功且路径已生效；如果报 command not found，不是没装好，而是 shell 没刷新 PATH 或安装路径没加入环境变量。
- Linux/macOS：检查
/usr/bin/cmake或/usr/local/bin/cmake是否存在，再运行echo $PATH看这些路径是否在其中 - macOS Homebrew 安装后，常见路径是
/opt/homebrew/bin/cmake（Apple Silicon）或/usr/local/bin/cmake（Intel），需手动加进 shell 配置（如~/.zshrc） - Windows：安装时勾选 “Add CMake to the system PATH for all users” 才能全局使用；若没勾，就得用安装目录下的完整路径，比如
"C:\Program Files\CMake\bin\cmake.exe"
cmake . 和 cmake -S . -B build 的区别
老写法 cmake . 是在当前目录生成构建文件，容易污染源码树；新推荐写法 cmake -S . -B build 明确分离源码和构建输出，更安全、更可复现。
-
cmake .：要求当前目录有CMakeLists.txt，所有中间文件（CMakeCache.txt、Makefile等）全堆在当前目录 -
cmake -S . -B build：源码在当前目录（-S .），构建输出全放进build/子目录（-B build），干净且支持多配置并存（比如再建build-debug） - 一旦用了
-B，后续所有操作都得带构建目录，比如cmake --build build，而不是make
为什么 cmake 报错 “CMakeLists.txt not found”
不是 CMake 有问题，是你没站在对的位置执行命令。
- 错误做法：在
src/或build/子目录里执行cmake .—— 它只会找当前目录下的CMakeLists.txt - 正确做法：cd 到项目最外层目录（即
CMakeLists.txt所在目录），再运行cmake -S . -B build - 大小写敏感：Linux/macOS 下
CMakeLists.txt必须全大写，cakelists.txt或Cmakelists.txt都不行 - 别用相对路径糊弄：
cmake -S ../myproj可以，但cmake -S .中的.指的是你当前所在的目录，不是“项目根目录”的模糊概念
真正卡住人的地方，往往不是语法或逻辑，而是路径没对齐、PATH 没生效、或者把构建目录和源码目录混在一起了。CMake 本身不难，它只认两件事：你给的路径对不对，以及 CMakeLists.txt 有没有按规矩放好。
