答案是path未正确配置。根本原因是cmake安装路径未加入系统环境变量path:windows需在.msi安装时勾选“add cmake to the system path”,linux/macos用包管理器(如apt、brew)可自动配置,手动安装则须将bin目录(如/usr/local/bin或/applications/cmake.app/contents/bin)添加至~/.zshrc等配置文件并source生效。

装完 CMake 却在命令行里敲 cmake --version 报“command not found”?不是没装好,大概率是 PATH 没配对——这是新手卡住的第一关。
Windows 安装时必须勾选 “Add CMake to the system PATH”
官网下载的 .msi 安装包在第二步(License Agreement 后)会出现两个 PATH 选项:
– “Add CMake to the system PATH for all users”
– “Add CMake to the system PATH for the current user”
无论选哪个,都得勾。不勾 = 安装成功但命令不可用。
如果已经跳过了:
- 重装一次,这次别漏勾
- 或手动把 CMake 的
bin目录(比如C:\Program Files\CMake\bin)加进系统环境变量PATH - 改完后**必须重启终端**(CMD/PowerShell/VS 开发者命令提示符),旧窗口不会自动加载新 PATH
Linux/macOS 用包管理器安装更稳,别硬下二进制包
apt、brew、dnf 等包管理器装的 CMake 自动注册 PATH,省去路径配置环节。二进制包(.tar.gz)虽可免 root,但需手动解压 + 添加 bin 到 PATH,容易漏写或拼错路径。
推荐命令:
- Ubuntu/Debian:
sudo apt install cmake - macOS(Homebrew):
brew install cmake - Fedora/RHEL:
sudo dnf install cmake
验证只用一行:cmake --version,输出带 version X.Y.Z 就算过。
VS 用户别单独装 CMake,用自带的就行
Visual Studio 2019+(尤其是 VS2022)安装时勾选了 “CMake tools” 组件后,会自带一个 MSVC 编译器适配版的 CMake(版本号带 -msvc6 这类后缀)。它和系统 PATH 里的 CMake 可能冲突。
正确做法:
- 打开 VS 自带的 “x64 Native Tools Command Prompt for VS 2022”
- 在里面运行
cmake --version,确认可用即可 - 不要在普通 CMD 或 PowerShell 里混用 VS 自带 CMake 和手动安装的 CMake
否则可能遇到 CMAKE_CXX_COMPILER:MSVC 被覆盖、生成器选错(比如本该用 Visual Studio 17 2022 却强行用了 Ninja)等问题。
验证通过后,立刻建个最小构建目录结构
别急着写复杂项目。先跑通最简闭环:
- 新建文件夹
hello_cmake - 里面放
main.cpp(含std::cout)和CMakeLists.txt(三行:cmake_minimum_required、project、add_executable) - 终端进该目录,执行:
mkdir build && cd build && cmake .. && cmake --build .
这四步连贯跑通,才说明环境真就绪了。中间任何一步失败,问题一定出在 PATH、编译器缺失,或 CMakeLists.txt 语法错误——而不是 CMake 本身有问题。
最容易被忽略的是:CMake 不检查编译器是否存在,直到 cmake .. 阶段才报错,而错误信息往往只说 “No CMAKE_CXX_COMPILER could be found”,实际意思是“你根本没装 g++ / cl.exe / clang++”。











