add_compile_options

为源文件编译添加选项。

add_compile_options(<option> ...)

向 COMPILE_OPTIONS 目录属性添加选项。这些选项在编译当前目录及以下目录中的目标时使用。

注意

这些选项在链接时不会使用。请参阅 add_link_options() 命令。

参数

add_compile_options 的参数可以使用 $<...> 语法的生成器表达式。请参阅 cmake-generator-expressions(7) 手册了解可用表达式。请参阅 cmake-buildsystem(7) 手册了解有关定义构建系统属性的更多信息。

选项去重

用于目标的最终选项集通过累积当前目标及其依赖项的使用要求的选项来构建。选项集经过去重以避免重复。

版本 3.12 新增：虽然对单个选项有利，但去重步骤可能会拆分选项组。例如，-option A -option B 会变成 -option A B。可以使用类似 shell 的引用加上 SHELL: 前缀来指定一组选项。SHELL: 前缀会被移除，选项字符串的其余部分会使用 separate_arguments() UNIX_COMMAND 模式进行解析。例如，"SHELL:-option A" "SHELL:-option B" 会变成 -option A -option B。

示例

由于不同的编译器支持不同的选项，此命令的典型用法是在特定于编译器的条件语句中

if (MSVC)
    # warning level 4
    add_compile_options(/W4)
else()
    # additional warnings
    add_compile_options(-Wall -Wextra -Wpedantic)
endif()

要设置每语言选项，请使用 $<COMPILE_LANGUAGE> 或 $<COMPILE_LANGUAGE:languages> 生成器表达式。

另请参阅

• 此命令可用于添加任何选项。但是，对于添加预处理器定义和包含目录，建议使用更具体的命令 add_compile_definitions() 和 include_directories()。

• 命令 target_compile_options() 添加目标特定选项。

• 此命令为所有语言添加编译选项。使用 COMPILE_LANGUAGE 生成器表达式来指定每语言编译选项。

• 源文件属性 COMPILE_OPTIONS 为一个源文件添加选项。

• add_link_options() 添加链接选项。

• CMAKE_<LANG>_FLAGS 和 CMAKE_<LANG>_FLAGS_<CONFIG> 添加了传递给编译器所有调用的全局语言标志。这包括驱动编译和驱动链接的调用。