1. CMake入门：CMake是什么、为什么选择CMake、CMake的核心哲学与基本工作流程

1.1 CMake到底是什么？

先别急着看定义。我直接说人话：CMake是一个跨平台的构建系统生成器。

什么意思呢？你写C++代码，总得把它变成可执行文件吧？在Linux上你可能用Makefile，在Windows上你可能用Visual Studio的.sln文件，在macOS上你可能用Xcode项目。每个平台、每个IDE都有自己的构建方式，手动维护一套简直要命。

CMake就是来解决这个问题的。你只需要写一份CMakeLists.txt，它就能帮你生成对应平台的构建文件。说白了，CMake不直接编译代码，它负责生成让别人去编译的东西。

我记得刚入行那会儿，公司有个项目要在Linux和Windows上同时跑。维护两套构建脚本，每次改个源文件路径都得同步修改，烦得不行。后来引入CMake，一份配置搞定所有平台——嗯，真香。

一句话总结：CMake = 跨平台构建脚本的「翻译官」。

1.2 为什么选择CMake？

市面上构建工具不少，Make、Autotools、Bazel、Meson……为什么偏偏选CMake？我列几个实际原因：

  • 跨平台能力：一套代码，Windows/Linux/macOS全搞定。我在项目中遇到过客户突然要求从Linux迁移到Windows，CMake改个生成器参数就完事。
  • 生态成熟：几乎所有C++开源库都支持CMake。你想想看，用find_package引入第三方库，比手动配置路径省多少事？
  • IDE集成：Visual Studio、CLion、Qt Creator、VS Code……主流IDE原生支持CMake。你不需要额外插件。
  • 模块化设计：通过add_subdirectory组织大型项目，每个模块独立管理，互不干扰。
  • 社区活跃：遇到问题，StackOverflow上一搜一大把。我当年踩过的坑，基本都能找到现成答案。

当然，CMake也有缺点。语法有点反人类，调试起来偶尔让人抓狂。但说实话，在跨平台C++构建这个领域，它目前没有真正的对手。

1.3 CMake的核心哲学

理解CMake的设计思想，比死记硬背命令重要得多。我个人总结了三句话：

  1. 源文件在外，构建目录在内：CMake强烈建议「out-of-source」构建。也就是源代码目录和构建产物目录分开。为什么？因为这样你随时可以删掉build目录重新构建，不会污染源码。我曾经见过同事直接在源码目录里编译，结果git clean都救不回来……
  2. 声明式而非命令式：你告诉CMake「我要一个可执行文件，它由这些源文件组成」，而不是「先编译a.cpp，再链接b.cpp」。CMake自己会推导依赖关系。
  3. 目标（Target）是核心：从CMake 3.0开始，一切围绕「目标」展开。可执行文件是一个目标，库是一个目标，甚至自定义命令也可以是一个目标。目标之间通过target_link_libraries、target_include_directories传递依赖。

小技巧：写CMakeLists.txt时，多想想「这个目标需要什么」，而不是「这个目录下有什么文件」。前者是CMake的思维方式，后者是Make的思维方式。

1.4 基本工作流程

CMake的工作流程分两步走：

第一步：配置（Configure）

你运行cmake -B build，CMake读取CMakeLists.txt，检查编译器、库文件、头文件是否存在，然后生成构建文件（Makefile、.sln等）。

第二步：构建（Build）

你运行cmake --build build，CMake调用底层的构建工具（make、msbuild等）真正开始编译链接。

我画了个简单的流程图，帮你理解这个过程：

CMakeLists.txt cmake -B build Makefile cmake --build build 可执行文件

你看，就这么简单。配置一次，构建多次。实际项目中，你通常只需要在第一次或修改CMakeLists.txt后执行配置步骤，后续改源码只需要重新构建即可。

1.5 第一个CMake项目

光说不练假把式。我们写一个最简单的例子：

# CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(HelloWorld)

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

然后在终端里执行：

cmake -B build
cmake --build build
./build/hello   # Linux/macOS
# 或 build\Debug\hello.exe  # Windows

看到「Hello, CMake!」了吗？恭喜你，你已经入门了。

注意：千万不要把build目录提交到版本控制里。在.gitignore里加上build/，这是基本素养。我曾经见过有人把整个build目录提交上去，结果每次合并都冲突……

1.6 本章小结

这一章我们聊了：

  • CMake是什么——跨平台构建系统生成器
  • 为什么选它——生态好、跨平台、IDE支持强
  • 核心哲学——out-of-source、声明式、目标驱动
  • 基本流程——配置 + 构建，两步走

下一章，我们会深入CMakeLists.txt的语法细节，包括变量、条件判断、循环等。到时候你会发现，CMake的语法虽然丑，但用顺手了还挺顺的。

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