2、CMake安装与配置：跨平台安装指南、环境变量设置、验证安装

2.1 跨平台安装：别让第一步卡住你

说实话，CMake的安装本身并不复杂。但不同平台上的坑，我踩过不少。先说说最常见的三种操作系统。

Windows：别碰那个“下一步”按钮太随意

Windows用户最省心的方式是去官网下载安装包。但我个人习惯，安装时一定勾选“Add CMake to the system PATH for all users”。为什么？因为不勾的话，你后面在命令行敲cmake会提示“命令未找到”。

⚠ 我曾经犯过的错： 安装时选了“仅当前用户”，结果换了个账号登录，整个构建环境全废了。后来我统一用管理员权限安装，勾选“所有用户”，再也没出过问题。

另外，Windows上还有个选择：用Visual Studio自带的CMake。VS 2019及以上版本都集成了CMake支持。但我的建议是——还是单独装一份官方版本。VS集成的版本往往落后一两个小版本，而且有些模块路径处理方式不一样。

Linux：包管理器最省心，但版本要留意

Ubuntu/Debian用户直接：

sudo apt update
sudo apt install cmake

CentOS/RHEL用户：

sudo yum install cmake

嗯，这里要注意。系统自带的CMake版本通常比较老。比如Ubuntu 20.04自带的CMake是3.16.x，但很多新特性（比如CMAKE_CUDA_ARCHITECTURES）需要3.18以上。你想想看，如果你要编译一个需要CUDA的项目，老版本直接报错。

💡 我的做法： 从Kitware官方APT仓库安装。这样能拿到最新稳定版，而且自动处理依赖。 
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc | sudo apt-key add -
sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ focal main'
sudo apt update
sudo apt install cmake

macOS：Homebrew是王道

macOS用户，别去官网下dmg了。用Homebrew：

brew install cmake

为什么推荐Homebrew？因为它会自动处理路径，而且更新方便。我见过有人手动装dmg，结果/usr/local/bin和/Applications/CMake.app/Contents/bin两个路径打架，调用时版本不一致。用Homebrew就清爽多了。

2.2 环境变量设置：让系统找到CMake

装完CMake，第一件事就是确认PATH里有没有它。说白了，就是让系统知道“cmake”这个命令去哪找。

检查当前PATH

打开终端，敲：

# Windows (CMD)
echo %PATH%

# Linux/macOS
echo $PATH

看看输出里有没有CMake的安装路径。Windows上一般是C:\Program Files\CMake\bin，Linux/macOS通常是/usr/local/bin或/usr/bin。

手动添加PATH

如果没找到，手动加一下。Windows上：

  1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
  2. 在“系统变量”里找到Path，双击编辑
  3. 添加C:\Program Files\CMake\bin
  4. 点确定，重启终端

Linux/macOS上，编辑~/.bashrc或~/.zshrc：

export PATH="/usr/local/bin:$PATH"

然后source ~/.bashrc让它生效。

🔑 关键点： 环境变量设置后一定要重启终端，或者执行source命令。我见过有人改完没重启，然后跑来问我“为什么还是找不到cmake”……

2.3 验证安装：三行命令确认一切正常

装好配好，怎么知道没问题？三行命令搞定。

第一行：看版本

cmake --version

输出应该类似：

cmake version 3.27.6

如果看到版本号，说明安装成功。如果报“command not found”，回去检查PATH。

第二行：看帮助

cmake --help

这会列出所有可用选项。不用全看，扫一眼确认有输出就行。我习惯用这个命令快速验证CMake是否“活着”。

第三行：跑个最小示例

新建一个文件夹，里面放个CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(HelloCMake)
add_executable(hello main.cpp)

再写个main.cpp：

#include <iostream>
int main() {
    std::cout << "CMake works!" << std::endl;
    return 0;
}

然后执行：

mkdir build
cd build
cmake ..
cmake --build .

如果一切顺利，你会看到一个可执行文件hello（Windows上是hello.exe）。运行它：

./hello

输出CMake works!。嗯，到这里，你的CMake环境就彻底搞定了。

💡 我的习惯： 每次换新机器，我都会跑一遍这个最小示例。花不了两分钟，但能排除90%的环境问题。别等到项目编译报错才回头检查安装。

2.4 常见问题速查表

问题 原因 解决
cmake: command not found PATH未设置或安装不完整 检查PATH，重新安装并勾选“添加到PATH”
版本太旧（如3.10） 系统包管理器版本滞后 使用Kitware官方仓库或源码编译
Windows上找不到编译器 未安装Visual Studio或Build Tools 安装VS并确保“C++桌面开发”工作负载已勾选
macOS上cmake ..报错 Xcode Command Line Tools未安装 xcode-select --install

2.5 小结

安装CMake这件事，说白了就是三步：下载、配路径、验证。但每一步都有小细节。我个人建议，别图省事跳过验证环节。你想想看，如果环境没配好，后面写再多CMakeLists.txt也是白搭。

下一章，我们会深入CMake的基本语法。到时候你会发现，环境配好了，学起来才顺手。

← 上一章 📖 返回目录 下一章 →