答案是PATH未包含CMake GUI的命令行工具路径。根本原因是macOS终端默认PATH不含/Applications/CMake.app/Contents/bin，需手动添加该路径至~/.zshrc并source生效。
CMake 命令在终端找不到
这是 macOS 上最常遇到的“假性故障”：CMake GUI 已成功安装，但 cmake --version 报 zsh: command not found: cmake。根本原因不是没装，而是终端 PATH 没指向 CMake GUI 内置的命令行工具位置 —— 它藏在 /Applications/CMake.app/Contents/bin/ 里，而这个路径默认不在 PATH 中。
- 先确认它确实在那儿：
ls /Applications/CMake.app/Contents/bin/cmake，有输出就说明安装完好 - 临时测试可用：
/Applications/CMake.app/Contents/bin/cmake --version - 永久修复只需加一行到 shell 配置文件（
~/.zshrc或~/.bash_profile）：export PATH="/Applications/CMake.app/Contents/bin:$PATH" - 改完别忘了重载：
source ~/.zshrc，再试cmake --version
CMake 配置时报 “building for macOS-x86_64 but attempting to link with file built for macOS-arm64”
M1/M2/M3 Mac 默认用 arm64 架构，但某些 CMake 配置或依赖（比如 Homebrew 安装的 libomp）会误判为 x86_64，导致链接失败。这不是路径或权限问题，是架构声明不一致。
- 在项目根目录的
CMakeLists.txt开头附近添加：set(CMAKE_OSX_ARCHITECTURES "arm64") - 如果用了 OpenMP，
find_package(OpenMP)可能仍失败，需手动补全变量：set(OpenMP_CXX_FLAGS "-Xpreprocessor -fopenmp -I/opt/homebrew/Cellar/libomp/13.0.0/include")、set(OpenMP_libomp_LIBRARY "/opt/homebrew/Cellar/libomp/13.0.0/lib/libomp.dylib") - 注意：Homebrew 安装路径因芯片而异 — Apple Silicon 是
/opt/homebrew，Intel 是/usr/local，别抄错
VS Code 的 CMake Tools 插件报 “CMake executable not found”
即使终端里 cmake 能正常运行，VS Code 也可能报这个错。这是因为 VS Code 启动时不一定加载你的 shell 配置（尤其是通过 Dock 或 Spotlight 启动），所以它看不到你加进 PATH 的 CMake 路径。
- 首选方案：在工作区的
.vscode/settings.json中显式指定："cmake.cmakePath": "/Applications/CMake.app/Contents/bin/cmake" - 次选方案：用 Homebrew 安装 CMake（
brew install cmake），它会自动把cmake放进 PATH 且 VS Code 通常能识别 - 避免全局设置
cmake.cmakePath到用户 settings.json，否则换台机器或切环境容易失效
真正麻烦的不是报错本身，而是这些错误常常互相掩盖：PATH 不对 → 找不到 cmake → 误以为没装；cmake 找到了但架构没设 → 链接失败 → 又回头查编译器；VS Code 看不见 → 又怀疑插件坏了。盯住一个点，验证它是否真的成立，比同时调三个地方更省时间。
