[中英对照] 专业 CMake：实用指南（双语对照版电子书）

全书结构清晰，共分为七大部分，从基础入门到高级应用，层层递进，兼顾新手入门与资深开发者进阶需求。 （一）入门篇（I: Getting Started） 该部分聚焦 CMake 基础操作，帮助零基础开发者快速上手。首先介绍 CMake 的核心概念与整体工作流程，包括从项目配置、生成项目文件到执行构建工具的完整链路，同时强调安装最新 CMake 版本的重要性，尤其针对 Apple 平台等工具迭代较快的环境。接着详细讲解项目搭建，对比源码内构建（In-source Builds）与源码外构建（Out-of-source Builds）的优劣，明确推荐源码外构建以避免源码与构建产物混杂，还介绍了项目文件生成、构建工具运行的具体命令与参数，并给出选择合适项目生成器（如 Ninja、Visual Studio、Xcode）的建议。此外，通过最小项目案例，拆解cmake_minimum_required()、project()、add_executable()等核心命令的用法，涵盖 CMake 版本管理、项目名称与版本配置、可执行文件构建及代码注释规范，同时强调养成良好命名习惯（如项目名与目标名独立）和版本控制意识的重要性。最后介绍简单目标构建与基础测试部署，包括可执行文件（如 Windows GUI 应用、Apple 平台应用包）和库（静态库、共享库、模块库）的定义，以及目标间依赖链接的三种关系（PRIVATE、PUBLIC、INTERFACE），还讲解了基于 CTest 的测试用例定义与执行、基于install()命令的项目安装配置和基于 CPack 的打包流程，为后续深入学习奠定基础。 （二）基础篇（II: Fundamentals） 此部分深入 CMake 核心特性，构建扎实的理论基础。变量章节详细讲解变量的定义、作用域、类型（普通变量、环境变量、缓存变量）及操作（字符串处理、列表操作、数学计算），重点介绍缓存变量在项目自定义配置中的应用，如通过命令行或 GUI 工具修改缓存变量以控制构建选项。流程控制章节覆盖条件判断（if()命令的多种表达式形式，如布尔逻辑、字符串比较、文件系统检测）和循环（foreach()、while()），并介绍break()、continue()等循环中断命令的用法。子目录使用章节对比add_subdirectory()与include()的差异，前者创建新作用域且自动管理源码与构建目录对应关系，后者直接引入文件内容不创建新作用域，同时讲解项目相对路径变量的使用以确保项目结构灵活性。函数与宏章节阐述两者的定义、参数处理（含关键字参数解析）、返回值传递及调用机制差异，提醒开发者避免宏中使用return()导致的作用域问题。属性章节介绍 CMake 中各类实体（全局、目录、目标、源码文件等）的属性操作，包括设置（set_property()）、获取（get_property()）及常用属性含义，强调属性对构建细节的精准控制作用。生成器表达式章节是该部分重点，讲解其语法（如$判断构建类型）、应用场景（如多配置生成器下的条件编译、目标信息获取），帮助开发者编写更灵活的跨配置构建逻辑。此外，还涵盖模块、策略、调试诊断、构建类型、编译器与链接器基础等内容，为后续高级应用提供技术支撑。 （三）深度构建篇（III: Builds In Depth） 该部分聚焦项目构建的进阶技术，解决复杂场景下的构建难题。语言需求章节讲解如何为项目设置特定语言标准（如 C++20），包括直接指定标准版本和基于特性需求指定标准两种方式，特别关注 C++20 模块的构建要求。高级链接章节深入目标链接机制，包括强制使用目标进行链接、自定义库链接方式及依赖传递规则，确保多目标项目链接的正确性与高效性。目标类型章节详细介绍可执行文件、库（含导入库、接口库）等目标类型的特性与适用场景，如接口库用于封装头文件依赖。自定义任务章节讲解自定义目标（add_custom_target()）、构建步骤添加（add_custom_command()）及文件生成命令，支持开发者扩展构建流程以满足特殊需求（如生成代码、自定义编译步骤）。文件操作章节覆盖路径处理、文件复制、读写、系统操作、通配及下载上传，提供全面的文件管理方案。版本信息指定章节介绍项目版本的定义与源码中版本信息的访问方式，确保版本管理的一致性。库构建章节深入静态库、共享库的构建细节，包括共享库版本控制、接口兼容性维护、符号可见性设置及静动态库混合使用策略。工具链与交叉编译章节详细讲解工具链文件的编写（定义目标系统、选择工具、配置系统根目录），并以 Android 平台为例演示交叉编译流程，同时介绍 Apple 平台专属特性（如应用包、框架、通用二进制文件）的构建配置。构建性能优化章节提供多种优化手段，如统一构建（Unity Builds）、预编译头文件（Precompiled Headers）、并行构建、编译器缓存等，帮助开发者提升大型项目构建效率。 （四）测试与分析篇（IV: Testing And Analysis） 此部分专注项目质量保障，涵盖测试与代码分析全流程。测试基础章节讲解基于 CTest 的测试用例定义、执行环境配置、结果判定标准及测试分组与选择，支持多平台、多配置测试场景，包括交叉编译环境下的测试适配。测试资源与约束章节介绍测试依赖管理（测试夹具）、并行执行控制及资源约束配置，确保测试流程的稳定性与高效性。构建与测试模式章节讲解cmake --build与ctest的协同使用，简化构建与测试一体化流程。测试框架章节提供 GoogleTest、Catch2、doctest 等主流测试框架与 CMake 的集成方案，帮助开发者快速搭建测试环境。CDash 集成章节介绍将测试结果上传至 CDash 平台进行可视化分析与报告生成，支持持续集成流程。静态代码分析章节讲解clang-tidy、cppcheck等工具与 CMake 的集成，通过配置自动执行代码检查，提前发现代码潜在问题。动态代码分析章节涵盖 sanitizers（如地址 sanitizer、内存 sanitizer）和代码覆盖率分析工具的配置与使用，助力开发者定位运行时错误并评估测试完整性。 （五）部署与依赖篇（V: Deployment And Dependencies） 该部分解决项目部署与外部依赖管理问题。查找功能章节讲解 CMake 的查找机制，包括查找文件路径、程序、库及包，提供调试查找过程的方法，确保项目能正确定位外部依赖。安装章节详细介绍安装目录布局、目标安装、导出安装、导入目标安装及自定义安装逻辑，支持将项目产物按规范部署到指定位置。打包章节深入打包配置，包括组件化打包、多配置打包及多种打包生成器（如 ZIP、RPM、DEB）的使用，满足不同平台的分发需求。外部项目管理章节对比ExternalProject与FetchContent两种管理外部项目的方式，前者支持复杂外部项目构建流程，后者简化外部依赖的获取与集成，帮助开发者高效管理第三方依赖。依赖提供者章节介绍依赖提供者机制，支持自定义依赖获取逻辑，提升项目依赖管理的灵活性。此外，还讲解如何使项目具备可被其他项目消费的能力，包括规范命名、避免硬编码配置及正确获取依赖等最佳实践。 （六）项目组织篇（VI: Project Organization） 此部分关注大型项目的组织与管理方法。预设（Presets）章节讲解 CMake 预设的结构与使用，包括配置预设、构建预设、测试预设等，支持开发者统一项目配置，简化多环境构建流程。项目结构章节对比超级构建（Superbuild）与非超级构建两种项目结构，分析各自适用场景（如超级构建适合管理多个独立子项目），并介绍常见的顶层子目录布局（如 src、test、doc）及 IDE 项目配置技巧，帮助开发者规划清晰的项目结构。此外，还涵盖目标定义、文件清理、CMake 重运行触发条件及文件注入等项目管理细节，确保大型项目的可维护性与扩展性。 （七）特殊主题篇（VII: Special Topics） 该部分覆盖 CMake 在特殊场景下的应用。可执行文件调试章节讲解调试相关配置，包括工作目录设置、环境变量配置、Windows DLL 查找、命令行参数传递及 PDB 文件生成，帮助开发者高效调试构建产物。Qt 框架集成章节提供 Qt 项目与 CMake 的集成方案，包括 Qt 环境配置、标准项目搭建、命令与目标命名规范、自动生成（Autogen）、翻译及部署，支持开发者快速构建 Qt 应用。附录部分提供编译器缓存、sanitizers 配置、定时器依赖提供者等实用示例，为开发者解决特定问题提供参考。 三、适用人群与价值 本书适用于所有需要使用 CMake 进行项目构建的软件开发者，无论是刚接触 CMake 的新手，还是需要解决复杂构建问题的资深工程师。对于新手，书中循序渐进的内容的能帮助其快速掌握 CMake 基础操作与核心概念，搭建完整的项目构建流程；对于资深开发者，深度构建、测试分析、部署依赖等章节的高级技术，能助力其解决多平台、大型项目的构建难题，优化构建性能与质量。同时，书中贯穿的 “推荐实践”（Recommended Practices）为开发者提供规范的使用指南，帮助其规避常见错误，编写可维护、可扩展的 CMake 配置代码，是从事跨平台软件开发、尤其是 C/C++ 项目开发的必备参考资料。