cmake target_compile_options指令详解

target_compile_options 指令用于为指定的目标添加编译器选项。通过这些选项，可以影响编译器如何处理目标的源代码。

语法

target_compile_options(<target> [INTERFACE|PUBLIC|PRIVATE] <options>...)

• target: 要应用这些编译选项的目标，通常是通过 add_executable 或 add_library 定义的目标。
• INTERFACE: 编译选项将仅应用于使用此目标的其他目标，不会应用于该目标本身。通常用于库的公共 API。
• PUBLIC: 编译选项将应用于该目标及所有链接到该目标的目标。适用于库的公共部分和使用该库的可执行文件或其他库。
• PRIVATE: 编译选项将仅应用于该目标，不会传播给其他依赖于该目标的目标。

示例

1. 为目标添加私有编译选项:

add_executable(my_executable main.cpp)

# Add a compile option for this target
target_compile_options(my_executable PRIVATE -Wall -Wextra)

在这个例子中，-Wall 和 -Wextra 选项将仅应用于 my_executable 目标，编译器在编译 main.cpp 时会启用这些警告选项。

2. 公共编译选项:

add_library(my_library my_library.cpp)
target_compile_options(my_library PUBLIC -O3)

add_executable(my_executable main.cpp)
target_link_libraries(my_executable my_library)

在这个例子中，-O3 优化选项不仅应用于 my_library 的编译，还会传递到链接到 my_library 的所有目标中，例如 my_executable。

3. 接口编译选项:

add_library(my_library INTERFACE)
target_compile_options(my_library INTERFACE -DINTERFACE_OPTION)

add_executable(my_executable main.cpp)
target_link_libraries(my_executable my_library)

这里，my_library 是一个接口库，它本身不编译代码，但 -DINTERFACE_OPTION 选项会传递给所有链接到 my_library 的目标，即 my_executable。

使用场景

• 启用编译器警告或错误: 强制所有目标或特定目标在编译时启用额外的警告或错误。
• 编译优化: 为不同的目标设置不同级别的优化选项，如 -O2、-O3。
• 跨平台支持: 根据不同的平台设置特定的编译器选项，如 -std=c++11、-fPIC。

通过 target_compile_options，你可以精细控制每个目标的编译选项，确保项目在不同环境下以最佳配置编译。