Skip to main content

1 / 4概念

Toolchain: CMake

CMake 不编译源码,它生成一套能编译源码的构建文件。判断一份 CMakeLists.txt 是否合格,不看命令是否齐全,而看三件事:使用要求是否挂在 target 上、下游能否只靠 find_package 就拿到同样的编译选项、增量构建能否只重编受影响的目标。

1 概念​

1.1 一句话定义​

CMake 是构建系统生成器:configure 阶段执行 CMakeLists.txt 并写出 CMakeCache.txt,generate 阶段产出 Ninja、Makefile 或 Visual Studio 工程,build 阶段由生成器调用编译器。target 是唯一的属性载体,target_* 命令写属性,PRIVATE、PUBLIC、INTERFACE 决定属性是否流向下游。

1.2 它解决什么问题​

  • 跨平台一套描述:同一份 CMakeLists.txt 在 Ninja 与 Visual Studio 下都能生成可构建工程。
  • 安装与消费:install(EXPORT) 让下游用 find_package 拿到 imported target,而不是手写 -I 与 -l。
  • 可复现配置:presets 把生成器、构建目录与缓存变量写进仓库,消除“本机能过、CI 不能过”。

1.3 不属于本页的内容​

主题去哪
-std、ABI 宏与编译器差异Toolchain: Compilers and Standards(cpp-compilers)
依赖获取、二进制缓存与 ABI 匹配Toolchain: Dependencies(cpp-dependencies)
ctest、sanitizer 与调试器Toolchain: Test and Debug(cpp-testing-and-debugging)

1.4 关键术语​

术语含义容易混淆的点
target构建图中的节点,库或可执行文件,也是一切属性的宿主不是源文件列表
imported target由外部包声明、本工程不构建的 target,通常带 ::不能修改其属性,只能读取
usage requirement跟随 target 传播给消费者的编译与链接要求不是全局变量
generator expressiongenerate 阶段求值,如 $<CONFIG:Debug> 与 $<BUILD_INTERFACE:...>不是 configure 阶段的变量
generator实际产出构建文件的程序:Ninja、Makefiles、VS、Xcode不是编译器
presetCMakePresets.json 中固化的配置、构建与测试参数不是 shell 脚本
toolchain file声明交叉编译的编译器、sysroot 与目标三元组只在首次 configure 生效