答案是PATH未生效,需勾选安装时的“Add CMake to the system PATH”选项并重启终端;验证用cmake --version,排查用echo %PATH%确认C:\Program Files\Cmake\bin是否存在。

装 CMake 不是为了“学构建系统”,而是为了让 cmake 命令能跑起来,后续才能生成 Makefile、Ninja 或 VS 工程——卡在这一步,项目根本动不了。
Windows 上装完 cmake 却提示“不是内部或外部命令”
这不是没装好,是 PATH 没生效。官方 MSI 安装包里有两个 PATH 选项:Add CMake to the system PATH for all users 和 Add CMake to the system PATH for current user。选哪个都行,但必须勾选其中一个。
- 勾选后,要重新打开 CMD 或 PowerShell(不是关掉再点开,是彻底关闭旧窗口,新开一个)
- 如果用的是 Windows Terminal,也得新开一个标签页,环境变量不会自动刷新
- 验证命令不是
cmake -version(少了个横杠),正确写法是:cmake --version - 若仍失败,手动查 PATH:在 CMD 中运行
echo %PATH%,看输出里有没有类似C:\Program Files\CMake\bin的路径
Linux 上用 apt install cmake 装完版本太低
Ubuntu 22.04 默认源里的 cmake 是 3.22,Debian 12 是 3.25,而很多现代项目(比如用 find_package(TBB CONFIG) 或 FetchContent 的)至少要求 3.20+,3.26+ 更稳妥。版本不够,cmake 会直接报错退出,不是警告。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 先运行
cmake --version确认当前版本 - 低于 3.24 的,别硬改源,直接下二进制包更稳:去 cmake.org/download 下
cmake-3.28.3-linux-x86_64.sh这类文件 - 执行:
bash cmake-3.28.3-linux-x86_64.sh --skip-license --prefix=/opt/cmake - 然后加到 PATH:
echo 'export PATH="/opt/cmake/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc - 注意:
sudo apt remove cmake不必要,新装的 bin 优先级更高
macOS 上用 Homebrew 装 cmake 后找不到编译器
cmake 本身不带编译器,它只负责调用。Homebrew 装完 cmake,不代表你就有 clang 或 gcc。常见现象是执行 cmake -S . -B build 时卡在 “Could NOT find CXX compiler”。
- 先确认 Xcode Command Line Tools 是否装了:
xcode-select --install(弹窗点安装,不是点“打开”) - 装完后运行
xcode-select -p,应输出类似/Library/Developer/CommandLineTools - 如果用 Homebrew 装了
gcc,想强制用它,得显式指定:cmake -S . -B build -DCMAKE_CXX_COMPILER=g++-13 - 不要删掉
/usr/bin/clang,CMake 默认就依赖它;删了反而让cmake找不到 fallback 编译器
真正麻烦的不是装 CMake,而是它后面那一长串依赖链:编译器、链接器、pkg-config、Python(某些 Find 模块需要)、甚至 Ninja(如果你用 -G Ninja)。每漏一个,cmake 就会在不同阶段报不同错,而且错误信息往往不直说缺啥——得靠 cmake --debug-output 或翻 CMakeCache.txt 才能看出端倪。

















