一、CMake入门：从零认识这个构建工具

说实话，我第一次接触CMake的时候，心里是有点抵触的。那时候我还在用Makefile，觉得写得挺顺手。直到有一次接手一个跨平台项目——Windows、Linux、macOS都要跑，还要支持不同的编译器——我才发现，Makefile那套东西，真的有点力不从心。

嗯，今天我们就来聊聊CMake。它到底是什么？为什么我们需要它？它的核心思想是什么？以及，怎么装起来跑一跑。

1.1 CMake是什么？

CMake，全称是Cross-platform Make。说白了，它是一个构建系统生成器。它不直接编译你的代码，而是帮你生成适合当前平台的构建文件——比如Linux下的Makefile，Windows下的Visual Studio工程文件，macOS下的Xcode项目。

你可以把它想象成一个翻译官。你写一份CMakeLists.txt，它就能翻译成各个平台能理解的构建脚本。我在项目中遇到过最典型的场景：团队里有人用VS，有人用CLion，还有人用命令行。一份CMakeLists.txt，大家都能用，省心不少。

核心定义：CMake是一个开源的、跨平台的构建系统生成工具。它使用CMakeLists.txt文件来描述构建过程，然后生成对应平台的本地构建文件。

1.2 为什么需要CMake？

你可能会问：我直接用Makefile不行吗？当然行。但现实是，现代C++项目越来越复杂，依赖越来越多，平台差异也越来越大。我见过不少项目，Makefile写了一两千行，最后换个编译器就崩了。

CMake能帮你解决几个痛点：

  • 跨平台：一套代码，Windows、Linux、macOS都能编译。我在项目中遇到过，同一个项目在Linux下用gcc，在Windows下用MSVC，CMake自动处理了编译器差异。
  • 依赖管理：通过find_package，可以轻松找到系统上安装的第三方库。比如OpenCV、Boost、Qt，一句find_package就搞定。
  • 生成器抽象：你不需要关心底层是Make还是Ninja，CMake帮你选最优的。我个人习惯用Ninja，编译速度比Make快不少。
  • 模块化：大型项目可以拆成多个子目录，每个子目录有自己的CMakeLists.txt，结构清晰。

我的建议：如果你刚开始一个新项目，或者要维护一个跨平台项目，直接用CMake。别犹豫。我见过太多人从Makefile迁移到CMake，没有一个人后悔的。

1.3 CMake的核心思想

CMake的设计哲学其实很简单：配置 -> 生成 -> 构建。这三个阶段是分开的，这也是它和传统Makefile最大的不同。

我们来画一张图，帮你理解这个流程：

CMakeLists.txt cmake 配置 Makefile / .sln 编译 & 链接 可执行文件 / 库 cmake --build 编写 生成

你看，整个过程很清晰：

  1. 编写CMakeLists.txt：描述你的项目需要哪些源文件、依赖哪些库、生成什么目标。
  2. 运行cmake命令：CMake读取CMakeLists.txt，根据当前平台和编译器，生成对应的构建文件（比如Makefile）。
  3. 运行构建命令：用cmake --build或者直接make，开始真正的编译和链接。

这里有个关键点：CMake本身不编译代码。它只负责生成构建规则。真正的编译工作，还是交给gcc、clang或者MSVC去做。我刚开始学的时候，总以为CMake是编译器，后来才明白——它是个管家，不是干活的工人。

注意：CMake生成的构建文件是平台相关的。比如在Windows上生成Visual Studio工程，在Linux上生成Makefile。所以不要把build目录提交到版本控制里。每次在新机器上重新cmake一下就好。

1.4 CMake的安装与验证

安装CMake其实很简单。不同平台的方法略有不同，我分别说一下：

平台 安装方式 命令/步骤
Ubuntu/Debian apt sudo apt install cmake
CentOS/RHEL yum sudo yum install cmake
macOS Homebrew brew install cmake
Windows 安装包 从官网下载.msi，安装后添加到PATH
通用 源码编译 下载源码，./configure && make && sudo make install

我个人习惯在Linux上用apt，在macOS上用brew。Windows的话，我建议直接下载官方安装包，安装时记得勾选“Add CMake to system PATH”。

装完之后，验证一下：

cmake --version

如果看到类似这样的输出，就说明安装成功了：

cmake version 3.28.3
CMake suite maintained and supported by Kitware (kitware.com/cmake).

嗯，这里要注意：版本号最好在3.10以上。太老的版本有些特性不支持。我曾经在CentOS 7上遇到过系统自带的cmake是2.8，很多现代语法用不了，后来还是手动装了新版本。

小技巧：如果你需要同时管理多个版本的CMake，可以用update-alternatives（Linux）或者直接下载预编译的二进制包，放到/opt目录下，通过软链接切换。

1.5 第一个CMake项目

光说不练假把式。我们来写一个最简单的CMake项目，感受一下。

创建一个文件夹，里面放两个文件：

main.cpp

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

CMakeLists.txt

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

然后在终端里执行：

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

你会看到编译过程，最后生成一个可执行文件hello（Windows下是hello.exe）。运行它：

./hello

输出：

Hello, CMake!

就这么简单。你想想看，三行CMakeLists.txt，就搞定了一个跨平台的构建配置。如果换成手写Makefile，至少得七八行，还得考虑不同平台的差异。

核心总结：CMake的核心价值在于——一次编写，到处构建。你只需要维护一份CMakeLists.txt，就能在主流平台上完成编译。这就是它成为C++构建事实标准的原因。

好了，这一章的内容就到这里。CMake的基本概念、核心思想、安装验证，以及第一个小例子，我们都走了一遍。下一章我们会深入CMakeLists.txt的语法，看看如何控制编译选项、添加库依赖、组织多目录项目。

公众号:蓝海资料掘金营，微信deep3321

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