安装cmake前必须确认三件事:编译器已安装(如gcc、clang、msvc)、path环境变量可写(windows需勾选“add to path”,linux/macos需确保/usr/local/bin等路径在$path中)、网络能访问cmake.org或系统软件源,缺一不可。

安装 CMake 前,你得先确认三件事:编译器有没有、环境变量能不能写、网络能不能访问官网或源。缺一不可,否则装完也跑不起来。
系统和编译器必须就位
CMake 本身不编译代码,它只生成构建指令,真正干活的是 gcc、g++、clang 或 MSVC。没它们,cmake --build 直接报错“no compiler found”。
- Linux(Ubuntu/Debian):运行
sudo apt install build-essential,它会自动带上gcc、g++、make - CentOS/RHEL:用
sudo yum install gcc gcc-c++ make(或dnf) - Windows:装 Visual Studio(带 Desktop development with C++ 工作负载),或 MinGW-w64;别只下 CMake 却忘了编译器
- macOS:装 Xcode Command Line Tools,执行
xcode-select --install
PATH 环境变量必须可写
Windows 安装时勾选 “Add CMake to the system PATH” 是最省事的;Linux/macOS 如果用包管理器(如 apt、brew)装,一般自动搞定;但手动编译安装(比如从源码 ./bootstrap && make && sudo make install)后,/usr/local/bin 可能不在默认 PATH 里。
- 检查方法:终端输
echo $PATH,看有没有/usr/local/bin(Linux/macOS)或C:\Program Files\CMake\bin(Windows) - 补救方式:Linux/macOS 编辑
~/.bashrc或~/.zshrc,加一行export PATH="/usr/local/bin:$PATH",再source一下 - 不配 PATH 的后果:命令行能运行
cmake --version,但 IDE(如 CLion、VS Code)可能找不到cmake,报 “command not found”
网络要能访问 cmake.org 或镜像源
不是所有系统都能直连官网下载页,尤其国内部分企业/校园网。这时候包管理器可能卡在下载环节,或者 curl 下载失败。
- Ubuntu/Debian:如果
apt update失败,先换源(如清华、阿里云镜像) - CentOS/RHEL:
yum install cmake失败时,检查baseurl是否可用,或改用 EPEL 源 - 手动下载:去 cmake.org/download 找对应系统的二进制包(如
cmake-3.28.3-linux-x86_64.tar.gz),解压后把bin目录加进PATH即可,不依赖网络
最容易被忽略的其实是编译器和 PATH 的联动——装了 CMake 却没装 g++,或者装了但没把 CMake 路径写进 PATH,结果 cmake .. 成功,cmake --build . 直接崩。这两步必须一起验证,不能只测 cmake --version。











