1、CMake初体验：什么是CMake？为什么现代C++项目离不开它？

说实话，我刚开始接触C++项目时，对构建工具完全没概念。那时候写个小程序，直接在IDE里点一下「运行」就完事了。直到有一次接手一个跨平台项目——Windows上能编译，到了Linux上就报一堆链接错误，Mac上更是直接罢工。折腾了两天，最后发现是不同平台的头文件路径和库链接方式不一样。

嗯，从那天起，我老老实实开始学CMake。

1.1 CMake到底是什么？

CMake全称是Cross Platform Make。说白了，它是一个构建系统生成器。你写一份CMakeLists.txt，它就能帮你生成对应平台的构建文件——Windows上是.sln解决方案，Linux上是Makefile，macOS上也能生成Xcode项目。

你想想看，如果没有CMake，你要维护三套不同的构建脚本。有了它，一份配置到处编译。我在项目中遇到过最典型的场景：团队里有人用VS，有人用CLion，还有人用Vim+命令行。CMake让所有人都能用自己顺手的工具，但共享同一套构建逻辑。

核心概念：CMake不是编译器，也不是构建工具。它是「构建工具的工具」——帮你生成构建脚本。

1.2 为什么现代C++项目离不开它？

我总结了几点，你看看是不是这个理：

  • 跨平台是刚需——现在哪个项目不得跑Windows、Linux、macOS？CMake原生支持三大平台。
  • 依赖管理——现代C++项目很少是孤岛，总有第三方库。CMake的find_package和FetchContent能优雅地处理依赖。
  • 目标导向——从CMake 3.0开始，引入了「目标（Target）」的概念。你可以把库、可执行文件、头文件路径、编译选项都绑定到一个目标上，清晰又干净。
  • 生态成熟——几乎所有C++开源项目都在用CMake。你随便拉一个GitHub上的C++项目，十有八九都有CMakeLists.txt。
我的建议：如果你还在用纯Makefile或者手写编译命令，趁早切换到CMake。刚开始可能觉得多了一层抽象，但项目一复杂，你就知道它的好了。

1.3 从一个最简单的Hello World开始

光说不练假把式。我们直接上手写一个最简单的CMake项目。

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

hello_cmake/
├── CMakeLists.txt
└── main.cpp

main.cpp 的内容很简单：

#include <iostream>

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

然后是最关键的 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(HelloCMake VERSION 1.0.0 LANGUAGES CXX)

add_executable(hello main.cpp)

就这三行。我们来拆解一下：

命令 作用
cmake_minimum_required 指定CMake最低版本。低于这个版本会报错。我个人习惯写3.10以上，因为很多现代特性从3.0开始引入，3.10比较稳妥。
project 定义项目名称、版本号、使用的语言。这里我们只用了C++，所以写CXX。
add_executable 告诉CMake：我要生成一个可执行文件，名字叫hello，源文件是main.cpp。
注意：CMake是大小写不敏感的，但社区惯例是命令用小写，变量用大写。比如add_executable和ADD_EXECUTABLE都能用，但建议统一风格。

1.4 编译运行

在终端里进入项目目录，执行：

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

解释一下这几步：

  • mkdir build——创建一个独立的构建目录。这是CMake的推荐做法，叫「out-of-source build」。构建产生的中间文件不会污染源码目录。
  • cmake ..——CMake读取上一级目录的CMakeLists.txt，生成构建系统。在Linux上默认生成Makefile。
  • cmake --build .——执行构建。等价于在Linux上直接敲make，但更通用，跨平台也能用。

构建完成后，你会看到build目录下多了一个hello可执行文件（Windows上是hello.exe）。运行它：

./hello
# 输出: Hello, CMake!

看到这行输出，你的第一个CMake项目就跑起来了。

1.5 CMakeLists.txt的基本结构

刚才那个例子只有三行，但实际项目会复杂很多。我画了一张图，帮你理解CMakeLists.txt的核心骨架：

CMakeLists.txt 核心结构 版本声明 cmake_minimum_required 项目定义 project() 目标定义 add_executable / add_library 可选扩展模块 头文件路径 target_include_directories 链接库 target_link_libraries 编译选项 target_compile_options 核心原则 先声明版本 → 定义项目 → 添加目标 所有配置都绑定到「目标」上，而不是全局设置

从图上你能看到，CMakeLists.txt的核心流程是：版本声明 → 项目定义 → 目标定义。后面的头文件路径、链接库、编译选项都是围绕「目标」展开的。

我曾经见过有人把所有源文件、所有头文件路径、所有库都写在全局变量里，整个CMakeLists.txt乱成一锅粥。后来项目一扩展，根本没法维护。所以从第一天起，就要养成「目标导向」的习惯。

一个小技巧：刚开始写CMakeLists.txt时，先只写最核心的三行。跑通了，再一点点加功能。别一上来就想把所有配置写全，容易把自己绕晕。

1.6 避坑指南

最后分享几个我踩过的坑：

  • 不要在源码目录里构建——永远用mkdir build && cd build && cmake ..。否则生成的中间文件会跟源码混在一起，清理起来很麻烦。
  • 注意CMake版本——有些语法在低版本里不支持。比如target_include_directories是CMake 2.8.12才引入的。如果你写的版本号太低，用户可能用不了新特性；写太高，用户可能升级不了。我一般写cmake_minimum_required(VERSION 3.10)，兼顾了功能与兼容性。
  • 文件名不要有中文和空格——CMake虽然支持，但某些生成器（比如Visual Studio）处理起来会出奇怪的问题。老老实实用英文和下划线。

好了，这一章就到这里。你已经在自己的机器上跑通了第一个CMake项目，也理解了CMakeLists.txt的基本骨架。接下来，我们会一步步深入，看看CMake到底能帮我们做多少事。

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

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