1. CMake Presets 概述：什么是 CMake Presets，为什么需要它，解决的问题与核心价值
咱们直接开门见山。CMake Presets，说白了就是一套标准化的构建配置方案。它把那些你每次都要手动敲的、或者写在文档里让大家照着配的 CMake 参数，统统固化到一个 JSON 文件里。嗯，就是 CMakePresets.json 这个文件。
我记得刚接触 CMake 那会儿，最头疼的就是团队协作。每个人机器环境不一样，编译器路径不同，构建类型也五花八门。有人用 Debug，有人用 Release，还有人喜欢开一堆奇奇怪怪的 flag。每次新人加入，光配置构建环境就能折腾半天。你想想看，这得多浪费时间？
为什么需要 CMake Presets？
我个人习惯把 CMake Presets 看作是构建配置的「标准模板」。它解决了一个非常实际的问题：如何让不同机器、不同开发者，用同一套规则来构建项目。
举个例子。以前我们项目里，构建命令是这样的：
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11 -DMY_FEATURE_FLAG=ON每次都要敲这么长一串，手一抖就敲错了。更麻烦的是，不同模块的开发者需要的 flag 还不一样。有人要开启测试，有人要关闭日志，有人要链接静态库……
有了 Presets 之后，你只需要这样：
cmake --preset=debug-gcc一行命令，搞定所有。背后的配置全在 JSON 里，清晰、可复用、可共享。
CMake Presets 解决了哪些问题？
我在项目中遇到过不少坑，总结下来，Presets 主要解决了这几个痛点：
- 配置碎片化：每个人都在自己的 shell 脚本里维护一套构建参数，版本混乱，没人知道哪个是最新的。
- 新人上手慢：新同事来了，先看 README，再问老员工，最后还要自己试错。有了 Presets，直接
cmake --list-presets一看，所有可用的构建方案一目了然。 - CI/CD 与本地不一致：很多项目 CI 里用的构建参数和本地开发不一样，导致「在我机器上能跑」的经典问题。Presets 可以把 CI 的配置也纳入同一个文件，保证一致性。
- 跨平台切换麻烦：Windows 上用 MSVC，Linux 上用 GCC，macOS 上用 Clang。每次切换平台都要重新配一遍。Presets 支持条件配置，一个文件搞定多平台。
核心价值一句话总结：CMake Presets 让构建配置从「口头传承」变成了「代码化管理」。你不再需要靠文档、靠记忆、靠运气来构建项目。
CMake Presets 的核心价值
咱们来拆解一下，它到底带来了哪些实实在在的好处：
| 价值维度 | 具体体现 |
|---|---|
| 可重复性 | 同样的 Presets，在任何机器上都能产生完全相同的构建配置。我踩过最深的坑就是「Debug 版本能跑，Release 版本崩了」，后来发现是 Release 的优化 flag 没统一。 |
| 可共享性 | 一个 CMakePresets.json 文件提交到 Git 仓库，全团队共享。不用再在群里发「你试试这个 cmake 命令」了。 |
| 可维护性 | 所有构建配置集中管理。要改一个 flag？改 JSON 文件就行，不用去翻十几个 shell 脚本。 |
| 可扩展性 | Presets 支持继承。你可以定义一个基础配置，然后派生出 Debug、Release、Sanitizer 等变体。改基础配置，所有派生自动生效。 |
一个小技巧：我个人习惯在项目根目录放两个文件——CMakePresets.json 和 CMakeUserPresets.json。前者是团队共享的，提交到 Git；后者是个人本地的，不提交。这样既保证了团队统一，又给个人留了自定义空间。
知识体系结构图
下面这张图，帮你快速理解 CMake Presets 在整个构建流程中的位置和作用：
一个简单的例子
光说不练假把式。咱们看一个最基础的 CMakePresets.json 长什么样：
{
"version": 3,
"configurePresets": [
{
"name": "default",
"displayName": "默认配置",
"description": "使用 GCC 的 Debug 构建",
"generator": "Unix Makefiles",
"binaryDir": "${sourceDir}/build",
"cacheVariables": {
"CMAKE_BUILD_TYPE": "Debug",
"CMAKE_C_COMPILER": "gcc",
"CMAKE_CXX_COMPILER": "g++"
}
}
]
}这个配置干了什么呢？它定义了一个叫 default 的 Preset。你只要在项目根目录执行 cmake --preset=default，CMake 就会自动：
- 使用 Unix Makefiles 作为生成器
- 把构建目录放在
build/下 - 设置编译器为 GCC
- 构建类型为 Debug
嗯，就这么简单。但你别小看它。我在实际项目中，一个 Presets 文件里往往有十几个配置——Debug、Release、ReleaseWithDebInfo、Sanitizer、Coverage、Cross-Compile……每个配置都对应不同的场景。
注意：CMake Presets 的 JSON 文件有严格的格式要求。我曾经因为多了一个逗号，排查了半天才发现是 JSON 语法错误。建议用支持 JSON Schema 的编辑器（比如 VS Code）来编辑，能省不少事。
什么时候该用 Presets？
我个人觉得，只要满足以下任意一条，你就该考虑用 Presets 了：
- 你的项目有超过 2 个开发者
- 你的项目需要在多个平台上构建
- 你的构建命令超过 3 个参数
- 你需要在 CI 和本地使用相同的构建配置
- 你厌倦了每次都要敲一长串 cmake 命令
说白了，Presets 就是帮你把「怎么做」这件事，从人的脑子里搬到文件里。人可能会忘，但文件不会。