第5章 目标与属性：目标的概念，设置目标属性，编译选项与链接选项

好，咱们今天聊聊CMake里最核心的概念——目标（Target）。说实话，很多初学者把CMake当成一个高级的“变量赋值器”，写一堆set()命令，最后发现项目一复杂就乱成一锅粥。我当年也踩过这个坑。

目标是什么？简单说，就是你最终要产出的东西。一个可执行文件、一个静态库、一个动态库，这些都是目标。CMake里的一切操作，说白了都是围绕目标展开的。

5.1 目标的概念

先看个最基础的例子：

add_executable(my_app main.cpp utils.cpp)
add_library(my_lib STATIC math.cpp io.cpp)

这里my_app和my_lib就是两个目标。前者是可执行文件，后者是静态库。

你可能会问：“这不就是告诉CMake要编译哪些文件吗？”嗯，没错，但远不止如此。目标真正的威力在于——它可以携带属性。

什么叫属性？就是跟这个目标相关的各种配置信息。比如：

• 这个目标需要包含哪些头文件目录
• 它链接了哪些库
• 编译时要加什么宏定义
• 用哪个C++标准

这些信息都挂在目标上，而不是散落在全局变量里。我在项目中见过最头疼的CMakeLists.txt，就是那种到处定义include_directories()和link_directories()的写法。一旦项目有几十个目标，你根本搞不清哪个目标用了哪些配置。

5.2 设置目标属性

设置目标属性，最常用的命令就是set_target_properties()。它的语法很直白：

set_target_properties(target1 target2 ...
    PROPERTIES prop1 value1
               prop2 value2 ...)

举个例子，我想给my_app设置C++17标准，同时加一个宏定义：

set_target_properties(my_app PROPERTIES
    CXX_STANDARD 17
    CXX_STANDARD_REQUIRED ON
    COMPILE_DEFINITIONS "USE_NEW_FEATURE=1"
)

这里CXX_STANDARD和COMPILE_DEFINITIONS都是目标的属性。CMake提供了几十种内置属性，常用的有这些：

属性名	作用	示例值
CXX_STANDARD	指定C++标准版本	11, 14, 17, 20
CXX_STANDARD_REQUIRED	是否强制使用指定标准	ON / OFF
COMPILE_DEFINITIONS	编译时宏定义	"DEBUG=1"
INCLUDE_DIRECTORIES	头文件搜索路径	/usr/local/include
LINK_LIBRARIES	链接的库	m, pthread
OUTPUT_NAME	输出文件名	my_custom_name
POSITION_INDEPENDENT_CODE	是否生成位置无关代码	ON / OFF

5.3 编译选项与链接选项

编译选项和链接选项，是目标属性里最常用的两类。咱们分开说。

5.3.1 编译选项

编译选项控制的是编译器怎么处理你的源代码。比如你想开启所有警告，或者想优化代码体积：

target_compile_options(my_app PRIVATE
    -Wall -Wextra -Wpedantic
    -O2
)

这里有个关键字PRIVATE，它表示这些选项只对my_app本身生效。CMake提供了三种访问级别：

• PRIVATE：只对当前目标生效
• PUBLIC：对当前目标和链接它的目标都生效
• INTERFACE：只对链接当前目标的目标生效，当前目标自己不用

嗯，这个设计很巧妙。你想想看，如果一个库的头文件里用了C++17的特性，那链接这个库的目标也必须用C++17编译。这时候就应该用PUBLIC或INTERFACE。

5.3.2 链接选项

链接选项控制的是链接器怎么把目标文件拼成最终的可执行文件或库。最常用的就是指定链接哪些库：

target_link_libraries(my_app PRIVATE
    my_lib
    pthread
    ${CMAKE_DL_LIBS}
)

这里my_lib是咱们自己编译的库，pthread是系统库。CMake会自动处理库的依赖关系——如果my_lib本身又链接了zlib，那my_app也会自动链接zlib（前提是my_lib把zlib声明为PUBLIC或INTERFACE）。

链接选项也可以传递其他参数给链接器：

target_link_options(my_app PRIVATE
    -static
    -Wl,--gc-sections
)

-static告诉链接器使用静态链接，-Wl,--gc-sections可以去掉未使用的代码段，减小最终文件体积。

5.4 知识体系总览

说了这么多，咱们用一张图来梳理一下本章的核心逻辑：

5.5 实战建议

最后，分享几个我在实际项目中的经验：

1. 优先使用target_*命令，而不是set_target_properties()。比如target_compile_definitions()比set_target_properties(... COMPILE_DEFINITIONS ...)更直观，而且支持PRIVATE/PUBLIC/INTERFACE。
2. 别滥用全局命令。add_compile_options()和link_directories()虽然方便，但会让依赖关系变得模糊。能用目标级别的命令，就别用全局的。
3. 属性可以继承。如果你用target_link_libraries(A PRIVATE B)，那么B的PUBLIC和INTERFACE属性会自动传递给A。这个机制非常强大，但也容易让人困惑。我的建议是：先搞清楚你的库是给谁用的，再决定属性的可见性。