CMake使用生成器表达式为不同配置设置链接选项异常排查

两类命令的语法规则差异是报错和配置失效的核心原因：

• set_target_properties 采用严格的键值对传参规则，格式固定为 set_target_properties(<target> PROPERTIES <prop1> <value1> <prop2> <value2> ...)，每个属性名后只能接收1个值参数。首次写法中INTERFACE_LINK_OPTIONS后跟随3个独立字符串，CMake会将后2个字符串解析为新的属性名，而合法属性名不支持$<开头的生成器表达式格式，因此触发参数数量错误。
• 重复声明同名属性时，set_target_properties会直接用新值覆盖旧值，不会做追加操作，因此第二次写法中仅最后一项Release配置生效。
• target_compile_options等target_*系列命令为追加语义，作用域关键字（如INTERFACE）后可接收任意多个值参数，全部会追加到对应目标属性中，因此多参数写法可正常运行。

方式1：使用set_target_properties #

将多组链接选项拼接为单个CMake列表（本质为分号分隔的字符串），满足单值传参要求即可：

# 若定义链接选项时使用空格分隔，需先转换为CMake标准列表格式
# 定义时直接用分号分隔选项可跳过此转换步骤
separate_arguments(win32DynLinkerFlagsAllConfigs NATIVE_COMMAND "${win32DynLinkerFlagsAllConfigs}")
separate_arguments(win32DynLinkerFlagsDebug NATIVE_COMMAND "${win32DynLinkerFlagsDebug}")
separate_arguments(win32DynLinkerFlagsRelease NATIVE_COMMAND "${win32DynLinkerFlagsRelease}")

set_target_properties(common_target PROPERTIES
    INTERFACE_LINK_OPTIONS
        "$<${isWindows}:${win32DynLinkerFlagsAllConfigs}>;$<${isWindows}:$<CONFIG:Debug>:${win32DynLinkerFlagsDebug}>>;$<${isWindows}:$<CONFIG:Release>:${win32DynLinkerFlagsRelease}>>"
)

生成阶段不满足条件的生成器表达式会自动展开为空字符串，不会引入冗余链接选项。

方式2：使用专用链接选项命令（推荐） #

CMake 3.13及以上版本提供target_link_options命令，语法与target_compile_options完全一致，原生支持多值追加，无需手动拼接列表，适配现有编译选项的配置逻辑：

# CMake 3.23版本完全兼容该命令
target_link_options(common_target
    INTERFACE
        "$<${isWindows}:${win32DynLinkerFlagsAllConfigs}>"
        "$<${isWindows}:$<CONFIG:Debug>:${win32DynLinkerFlagsDebug}>>"
        "$<${isWindows}:$<CONFIG:Release>:${win32DynLinkerFlagsRelease}>>"
)

• 所有列表类目标属性（如LINK_OPTIONS、COMPILE_OPTIONS、INCLUDE_DIRECTORIES等）通过set_target_properties设置时，都需要将多个值拼接为单个分号分隔的列表传入，不能传入多个独立参数。
• 非必要场景优先使用对应功能的target_*命令，避免手动处理列表拼接和属性覆盖问题。

内容的提问来源于stack exchange，提问作者Dess