CMake 核心概念与实战应用。涵盖 CMakeLists.txt 基础命令（minimum_required, project, include, install, add_executable），演示了基于 CMake 组织静态库依赖的程序运行流程。重点解析了现代 CMake 的三大核心：目标（Target）、属性（Property）和 API，阐述了属性传递机制（PRIVATE/PUBLIC/INTERFACE）及配置、生成、构建、安装四大工作流程。旨在帮助读者掌握现代 C++ 工程化构建的最佳实践。
cmake_minimum_required 命令CMakeLists.txt 文件的第一行。cmake_minimum_required(VERSION <min> [...<policy_max>] [FATAL_ERROR])
<min>：最重要的参数，用于指定一个最低版本号（例如 3.18）。如果当前运行的 CMake 版本低于此版本，配置将失败。<policy_max> (可选)：用于指定一个最高策略版本，此选项较少使用。FATAL_ERROR (可选)：显式指定版本不满足时报错并终止流程。对于 CMake 2.6 及以后的版本，这是默认行为，因此现代项目中通常无需再写。
project 命令CMakeLists.txt 文件的开头位置（通常在 cmake_minimum_required 之后）。project() 后，CMake 会自动创建一系列变量供后续使用，例如：
PROJECT_NAME: 项目名称PROJECT_VERSION: 项目的完整版本号PROJECT_SOURCE_DIR: 项目源代码的根目录路径PROJECT_BINARY_DIR: 项目构建的输出目录路径PROJECT_NAME 可用于动态库输出名称、cmake 配置文件名称、命名空间名称。PROJECT_VERSION 可用于打印变量、生成 pkg-config 或.cmake 对应的版本配置文件。
注意默认 project 的 languages 是 C 与 CXX。如果确定哪个语言就只写那个，否则就会都生成耗时间。这里一旦写错就会出现问题（比如把 CXX 程序改成 C），会导致找不到对应的编译工具。
include 命令.cmake 脚本）或模块中的 CMake 代码。include(<file|module> [OPTIONAL] [RESULT_VARIABLE <var>])
<file|module>：要包含的文件或模块名。OPTIONAL：可选关键字。如果找不到文件，不会报错，静默忽略。RESULT_VARIABLE <var>：可选关键字。将查找结果存入指定变量 <var> 中。<module>.cmake 的文件。include 的文件中的 CMake 代码会在当前上下文中立即执行。include 执行外部文件时，会改变以下 CURRENT 系列变量的值：
CMAKE_CURRENT_LIST_FILE：变为被包含文件的完整路径。CMAKE_CURRENT_LIST_DIR：变为被包含文件所在的目录路径。CMAKE_CURRENT_SOURCE_DIR 和 CMAKE_CURRENT_BINARY_DIR：保持不变，仍然是包含者（父 CMakeLists.txt）的源目录和构建目录。install 命令cp 命令一样，把编译好的程序、库文件、头文件、配置文件复制（部署）到指定的系统目录中。install(DIRECTORY 目录/ DESTINATION 目标路径)install(FILES 文件.h DESTINATION include)install(TARGETS 目标名 DESTINATION bin/lib)install 命令，记住要安装哪些文件。cmake_install.cmake)。make install 时，CMake 就运行这个脚本，把文件复制到指定位置。add_executable 命令.exe）的核心命令。target_name：必需。指定生成的可执行文件的名称（不含扩展名）。此名称在项目内部必须唯一。source1.cpp ...：必需。指定构建此可执行文件所需的源文件列表。CMakeLists.txt 源目录对应的构建目录中。可以通过设置目标的 RUNTIME_OUTPUT_DIRECTORY 属性来更改其默认的输出目录。总之，动态库使用的时候需要链接（可达共享）；而静态库直接就是归档文件，填进程序即可，无需链接操作。
下面基于顶层 CMakeLists.txt 以及底层 CMakeLists.txt 实现对应的程序与静态库编成可执行程序进行执行。
对应开始目录结构如下：
├── CMakeLists.txt
├── myapp
│ ├── CMakeLists.txt
│ └── main.cpp
└── my_lib
├── CMakeLists.txt
├── include
│ └── math.h
└── src
├── add.cpp
└── sub.cpp
这里我们把对应的 src 里的 cpp 文件以及包含对应 include 里面的 math.h 组成对应的静态库（头文件声明 + 源文件实现）。
编写对应的 main.cpp 出现了问题无法识别对应头文件，因为它在固定的目录找不到 math.h，因此需要添加头文件搜索路径。
对应的静态库生成的 CMakeLists.txt 文件：
# my_lib/CMakeLists.txt
add_library(my_static STATIC src/add.cpp src/sub.cpp)
target_include_directories(my_static PUBLIC include)
主函数结合静态库最终生成对应的执行程序的 CMakeLists.txt 文件：
# myapp/CMakeLists.txt
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE my_static)
顶层 CMakeLists.txt 文件只需要调用前两个底层即可：
# Top CMakeLists.txt
add_subdirectory(my_lib)
add_subdirectory(myapp)
下面进行运行，构建对应的程序及静态库的生成。
如果想要指定对应目录到指定的 build 目录里面，因此就可以调整生成的可执行程序的属性即可。 那两个底层 CMakeLists.txt 进行添加属性设置。如果不指定是顶层 CMake 对应生成的目标目录，它会相对当前的 CMakeLists 目录为相对目录生成对应那些文件。因为它是被顶层 CMake 调用的，因此会生成在 build 文件，但是又要保证与 my_lib 在同一目录，因此会生成在对应 build 的 my_lib 目录里。
删除 build 目录及缓存文件后重新生成，成功生成在指定目录了，运行成功。
现代 CMake 的核心是'目标（Target）'为中心的管理模式。每个库或可执行程序都是一个独立的目标，拥有自己的属性和行为。
三大核心概念：
add_library 或一个程序 add_executable）。target_include_directories, target_link_libraries）。关键机制：属性传递
| 关键字 | 对当前目标的构建影响 | 是否传播给下游目标？ | 通俗解释 |
|---|---|---|---|
| PRIVATE | 生效 | 否 | 私有属性：只给自己用，不告诉别人。 |
| PUBLIC | 生效 | 是 | 公共属性：自己要用，也告诉别人要用。 |
| INTERFACE | 不生效 | 是 | 接口属性：自己不用，但要求别人用。 |
这是现代 CMake 最强大的特性。通过 PUBLIC、PRIVATE、INTERFACE 关键字，一个目标的属性可以自动、精确地传递给依赖它的其他目标。
与面向对象编程的类比：
最终等式：目标 + 属性 + API + 属性传递机制 = CMake 现代化构建系统的核心。
CMake 中的'目标'就是你想让构建系统帮你生成的东西，主要分三大类：
set_target_properties)：用来记录或查看某块乐高（目标）的所有属性。target_compile_definitions)：告诉管理员某块乐高该怎么拼。target_link_libraries)：告诉管理员哪些乐高块可以拼在一起。install)：规定拼好的成品如何打包进盒子。CMakeLists.txt 脚本，登记所有要构建的目标，并记录下您设置的各种属性。一句话：CMake 就是一个自动化项目经理：它先理解您的构建需求（配置），然后制定详细的施工计划（生成），接着指挥工人干活（构建），最后负责产品的打包和部署（安装）。
本篇通过学习 CMake 三大核心（目标、属性、API）和完整构建流程（配置、生成、构建、安装），将掌握现代化 C++ 项目管理的关键技能。这些知识将显著提升开发效率和项目可维护性。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online