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> 添加传递给编译器所有调用的语言范围标志。这包括驱动编译和驱动链接的调用。