001-现代cmake编译指令
CMake 的命令行接口在 3.x 版本后，变得更加现代化和统一。核心变化是：用跨平台的 cmake 命令及 --build 等子命令，取代了原先直接依赖平台特定构建工具（如 make, ninja）的方式，从而提供了更流畅的开发体验。
这里将核心概念和命令总结如下，方便你快速查阅。
📝 命令解析速查表
1. 构建 (Build)
在主目录创建构建目录并配置项目
- 命令示例：
cmake -S . -B build - 核心解析：
-S <path>: 指定源码目录，-S .代表当前目录。-B <path>: 指定构建目录，CMake会自动创建它。
2. 配置与变量 (Configure & Variables)
设置编译模式、安装路径等变量来配置项目
- 命令示例：
cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local - 核心解析：
-D <var>=<value>: 定义或覆盖缓存变量，写入CMakeCache.txt，可多次使用。CMAKE_BUILD_TYPE: 核心变量，设置为Debug(调试),Release(性能最佳),RelWithDebInfo(带调试信息的发布版), 或MinSizeRel(体积最小)。CMAKE_INSTALL_PREFIX: 核心变量，指定cmake --install命令的安装路径。-C <initial-cache>: 初始化缓存文件，批量预设变量。
3. 生成器 (Generator)
选择CMake为哪个底层构建工具生成配置文件，如 Makefile 或 Ninja
- 命令示例：
cmake -B build -G Ninja - 核心解析：
-G <generator-name>指定生成器。推荐使用Ninja(速度快) 或Unix Makefiles(Linux通用)。运行cmake --help可查看全部支持列表。 - 查看支持列表：
cmake -G? 会报错，正确用法是cmake --help。
4. 构建项目 (Build)
执行构建，生成最终的可执行文件或库
- 命令示例：
cmake --build build --parallel 4 - 核心解析：
--build <dir>: 指向构建目录。--parallel [<jobs>]/-j [<jobs>]: 并行构建，<jobs>为并行任务数（如-j4）。不指定则自动使用所有CPU核心。--target <tgt>/-t <tgt>: 仅构建指定目标，如库名或all,clean。--config <cfg>: 多配置生成器必备，指定要构建的配置，如Debug或Release。
5. 安装项目 (Install)
将构建产物复制到系统目录中
- 命令示例：
cmake --install build --prefix ~/myinstall - 核心解析：
--install <dir>: 指向包含cmake_install.cmake的构建目录。--prefix <dir>: 覆盖配置阶段用CMAKE_INSTALL_PREFIX变量指定的安装路径。
6. 其他工具命令
执行脚本、文件系统操作等辅助功能
- 命令示例：
- 运行CMake脚本：
cmake -P MyScript.cmake。例如，一个简单的脚本可以包含message("Hello from CMake!")。 - 文件系统操作：
cmake -E <command>。例如，cmake -E copy source.txt dest.txt用于复制文件。
- 运行CMake脚本：
- 核心解析：
-P <script>: 直接运行CMake脚本文件。-E <command>: 内置的跨平台文件操作命令，类似cp,mkdir,rm等。
7. 预设 (Presets)
通过JSON文件预定义和共享构建配置参数，避免重复输入复杂命令行
- 命令示例：
- 列出预设：
cmake --list-presets - 使用预设配置：
cmake --preset linux-debug - 使用预设构建：
cmake --build --preset linux-debug-build - 使用工作流预设：
cmake --workflow --preset <workflow-name>
- 列出预设：
- 核心解析：
- 命令：
--list-presets: 列出可用的配置预设。--preset <name>: 使用指定的配置预设来配置项目。--workflow <options>: 运行一个工作流预设，可串联配置、构建、测试等多个步骤。
- 配置文件：
CMakePresets.json(项目共享) 和CMakeUserPresets.json(本地开发者专用)。
- 命令：
📖 深入理解核心概念
源码外构建 (Out-of-Source Build)：现代CMake的基石
现代CMake强力推荐“源码外构建”（out-of-source build）。这是现代CMake的核心实践。它严格区分项目源代码目录和构建输出目录，在源代码目录中通过命令创建独立的build目录，将所有编译产生的临时文件、目标文件都放在其中。
- 优点：保持源码目录整洁，便于版本控制（只需将
build目录加入.gitignore），并能用不同配置并行构建多个build目录（如build_release,build_debug）。
生成器 (Generator) 对并行构建的影响
--parallel (-j) 选项在 cmake --build 中表现统一，但底层生成器决定了默认行为和效率。
- Ninja 生成器：是注重速度的现代工具。使用
-G Ninja指定，默认就会充分利用CPU进行并行构建。 - Makefile 生成器：需通过
-j参数显式启用并行才更高效。make -j可自动全用CPU核心，但GNU make和CMake建议明确指定任务数，如-j4。
掌握多配置生成器
像Visual Studio (-G "Visual Studio 17 2022") 或 Xcode (-G Xcode) 这类IDE生成器属于“多配置生成器”（Multi-Config Generators），它们在配置阶段不决定构建类型，而是将 Debug、Release 等所有配置信息都写入生成的项目文件中。这与 Unix Makefiles 这类单配置生成器（由 CMAKE_BUILD_TYPE 定）不同。
- 关键使用差异：配置时无需（也不能）设置
-DCMAKE_BUILD_TYPE。构建时必须用--config指定：cmake --build build --config Release cmake --install build --config Release --prefix ~/myapp
预设工作流 (Workflow Presets) 提高效率
预设（Presets）功能（CMake 3.19+）进一步简化了复杂流程的配置。--workflow 是一项较新的特性，用于定义一个包含配置、构建、测试、打包等多个步骤的自动化流程。你可以预先定义一个包含上述所有步骤的 workflowPresets，然后在命令行中通过 cmake --workflow --preset my_workflow 一键执行整个流水线，极大提升了CI/CD或日常开发中重复性工作的效率。
⚠️ 常见问题与解决方案
CMake Error: The source directory ... does not appear to contain CMakeLists.txt: 当前目录不是有效的源码目录。检查-S参数或是否在正确的路径下执行命令。CMake Error: Could not find CMAKE_ROOT: CMake 安装可能损坏。需要重新安装CMake。- 缓存失效 (CMAKE_CXX_FLAGS 等修改无效): 直接修改
CMakeCache.txt或删除build目录下该文件，重新运行cmake命令。 - 命令行过长: 使用预设（Presets）功能将参数写入 JSON 文件。