“cmake: command not found”本质是shell无法定位可执行文件，90%因path未配置：linux/macos源码安装默认在/usr/local/bin但未入path，windows安装未勾选“add to path”，macos homebrew安装后shell配置未重载；验证需echo $path或%path%，修复后须source配置或重启终端，vs code需手动设置cmake.cmakepath。
“cmake: command not found”不是没装好，而是 shell 找不到它——90% 的问题出在 PATH 配置上。
为什么 cmake --version 报错？
错误本质是操作系统无法定位 cmake 可执行文件，和是否安装成功无关。常见触发场景：
- Linux/macOS 源码编译安装默认到
/usr/local/bin，但某些发行版（如 Alpine、最小化 CentOS）不把该路径加入默认$PATH - Windows 安装时没勾选 “Add CMake to the system PATH” 选项
- macOS 用 Homebrew 安装后，
~/.zshrc或~/.bash_profile没重载（尤其是 Catalina 之后默认 zsh）
验证方法：运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），看输出里有没有 cmake 所在目录（比如 /usr/local/bin、C:Program FilesCMakein）。
怎么快速定位 cmake 实际位置？
别猜路径，直接搜：
- Linux/macOS：
find /usr -name cmake 2>/dev/null或which cmake（如果已临时生效） - Windows：
dir "C:Program FilesCMakeincmake.exe" /s /b，或打开文件资源管理器手动找CMakeincmake.exe
找到后记下完整路径，比如 /opt/homebrew/bin/cmake（M1/M2 Mac）、C:Program FilesCMakeincmake.exe（Windows 默认）。
VS Code 提示 “cmake.cmakePath” 错误怎么办？
这是 VS Code 的 CMake Tools 插件找不到 cmake，它不读系统 PATH，必须显式指定：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）→ 输入 “Preferences: Open Settings (JSON)” - 在
settings.json里加一行："cmake.cmakePath": "/your/path/to/cmake" - 路径示例：
Windows："cmake.cmakePath": "C:\Program Files\CMake\bin\cmake.exe"
macOS（Homebrew）："cmake.cmakePath": "/opt/homebrew/bin/cmake"
Linux（源码安装）："cmake.cmakePath": "/usr/local/bin/cmake"
注意：Windows 路径要用双反斜杠 \ 或正斜杠 /，不能单反斜杠；macOS/Linux 不要漏掉 cmake 文件名本身。
PATH 修复后终端仍不识别？
环境变量修改后，新终端才生效。容易忽略的细节：
- Linux/macOS：改完
~/.zshrc或~/.bashrc后，必须运行source ~/.zshrc（zsh 用户）或source ~/.bashrc（bash 用户） - Windows：修改系统环境变量后，**所有已打开的 CMD/PowerShell/VS Code 终端都得重启**，否则 PATH 不刷新
- macOS GUI 应用（如 VS Code 图形界面启动）可能读的是
~/.zprofile，而非~/.zshrc，可把 export 行复制过去
验证是否真生效：新开一个终端，直接运行 which cmake（macOS/Linux）或 where cmake（Windows），有输出路径才算成功。
