2. 环境搭建:在不同操作系统上安装CMake

说实话,学任何工具的第一步,都是先把环境搞起来。CMake 的安装其实不复杂,但不同系统下确实有些小坑。我当年第一次在 Windows 上装 CMake,就被那个「添加到 PATH」的选项坑过——装完了在命令行里敲 cmake 死活找不到命令。嗯,后来才明白,勾选那个选项有多重要。

这一章,我会带你走一遍 Windows、Linux、macOS 三个平台上的安装流程。每个系统我都亲自踩过坑,所以哪些地方容易出问题,我会重点提醒你。

2.1 在 Windows 上安装 CMake

Windows 用户最省心的方式,就是去 CMake 官网下载安装包。我个人习惯用 Windows x64 Installer 这个版本,一路 Next 就行。但这里有个关键点——

安装时务必勾选「Add CMake to the system PATH for all users」。如果你漏了这一步,后面每次用 CMake 都得进安装目录敲命令,非常麻烦。

安装完成后,打开命令提示符(cmd)或者 PowerShell,输入:

cmake --version

如果看到类似 cmake version 3.28.1 这样的输出,说明安装成功了。如果提示「'cmake' 不是内部或外部命令」,那就是 PATH 没配好。别慌,手动加一下环境变量就行:

  1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
  2. 在「系统变量」里找到 Path,双击编辑
  3. 新增一行,填入 CMake 的安装目录(比如 C:\Program Files\CMake\bin
  4. 确定保存,重新打开命令行

我曾经帮一个同事排查过这个问题,他装了三遍都没勾那个选项……后来我直接远程过去帮他改了 PATH,一分钟搞定。

2.2 在 Linux 上安装 CMake

Linux 下安装 CMake 就简单多了。不同发行版用的包管理器不一样,但思路是一样的。

发行版 安装命令
Ubuntu / Debian sudo apt install cmake
CentOS / RHEL sudo yum install cmake
Fedora sudo dnf install cmake
Arch Linux sudo pacman -S cmake

装完之后同样验证一下:

cmake --version

这里有个小坑——系统自带的 cmake 版本可能比较老。比如 Ubuntu 20.04 默认装的是 3.16 版,但有些新特性需要 3.20 以上。如果你遇到这种情况,我建议用 Kitware 官方提供的 APT 源来装最新版:

# 先卸载旧版
sudo apt remove cmake

# 添加 Kitware 的签名密钥和源
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/ $(lsb_release -cs) main'
sudo apt update
sudo apt install cmake

为什么我推荐用官方源?因为我在一个项目里遇到过,系统自带的 CMake 不支持 FetchContent 模块,折腾了半天才发现是版本问题。从那以后,我养成了先查版本的习惯。

2.3 在 macOS 上安装 CMake

macOS 用户有两个选择:一是用 Homebrew,二是去官网下载 .dmg 安装包。我个人更推荐 Homebrew,因为后续更新方便。

brew install cmake

装完验证:

cmake --version

如果你选择用 .dmg 安装,记得把 CMake 拖到 Applications 文件夹里。然后打开终端,运行:

sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install

这个命令会在 /usr/local/bin 下创建 cmake 的符号链接。如果不做这一步,终端里照样找不到 cmake 命令。你想想看,装好了却用不了,多憋屈。

2.4 验证安装与设置环境变量

不管你在哪个系统上,装完之后都建议做两件事:

  1. 验证版本cmake --version 确认安装成功
  2. 测试一个最简单的项目:写个 CMakeLists.txt 跑一遍

创建一个测试目录,里面放一个 CMakeLists.txt

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

再写一个 main.cpp

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

然后在终端里执行:

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

如果一切顺利,你会看到一个可执行文件 hello(Windows 下是 hello.exe),运行它就能看到输出。这一步走通了,说明你的环境已经准备好了。

小技巧:我习惯把 CMake 的 bin 目录加到 PATH 的最前面,这样如果系统里有多个版本,会优先用我指定的那个。尤其是在 Linux 上,系统自带的旧版本经常和新版本冲突。

2.5 本章知识体系

下面这张图帮你梳理了本章的核心逻辑——从安装到验证,再到环境配置,一条线走下来:

CMake 环境搭建流程 Windows Linux macOS 安装包 / 勾选 PATH apt / yum / dnf Homebrew / .dmg 验证安装:cmake --version 测试项目:cmake .. → cmake --build .

说白了,环境搭建就三步:安装 → 验证 → 测试。不管你在哪个系统上,这个流程都不会变。把这一步走扎实了,后面学 CMake 语法、写 CMakeLists.txt 的时候,你才能把精力放在真正重要的地方。

核心要点回顾

  • Windows 安装记得勾选「添加到 PATH」
  • Linux 优先用官方源获取最新版本
  • macOS 用 Homebrew 最省心
  • 装完一定要跑一个测试项目验证
公众号:蓝海资料掘金营,微信deep3321