CMake配置GCC与Clang的LTO及函数级链接报错排查

报错原因 #

你遇到的GCC报错是因为单独的-Wl不是有效的编译/链接选项。-Wl,xxx是GCC/Clang用来将xxx参数传递给链接器的语法，其中逗号是分隔符，必须和具体的链接器选项写在一起，不能拆分单独写-Wl和--gc-sections。

修正后的CMake代码 #

# 开启Release模式下的函数/数据段分离与LTO编译选项
add_compile_options(
  $<$<CONFIG:Release>:-flto>
  $<$<CONFIG:Release>:-fdata-sections>
  $<$<CONFIG:Release>:-ffunction-sections>
)

# 开启Release模式下的LTO链接选项
add_link_options($<$<CONFIG:Release>:-flto>)

# 根据编译器类型添加链接器垃圾回收选项
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
  # GCC需要将--gc-sections通过-Wl,前缀传递给链接器，合并为单个选项
  add_link_options($<$<CONFIG:Release>:-Wl,--gc-sections>)
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
  # Clang可以直接用-dead_strip，或统一用-Wl,-dead_strip形式
  add_link_options($<$<CONFIG:Release>:-dead_strip>)
endif()

关键修改点说明 #

1. 合并-Wl与链接器选项：GCC不接受单独的-Wl参数，必须写成-Wl,--gc-sections的形式，让编译器识别这是传递给链接器的--gc-sections选项。
2. Clang的简化写法：Clang本身支持直接使用-dead_strip（无需-Wl,前缀），写成-Wl,-dead_strip也能正常工作，两种写法任选其一即可。
3. 保持LTO一致性：编译和链接阶段都需要添加-flto，确保LTO优化完整生效。

额外优化建议 #

如果是针对特定目标而非全局配置，推荐使用target_compile_options和target_link_options替代全局的add_compile_options/add_link_options，这样能更精准地控制编译选项的作用范围，示例如下：

add_executable(main main.cpp)

target_compile_options(main PRIVATE
  $<$<CONFIG:Release>:-flto>
  $<$<CONFIG:Release>:-fdata-sections>
  $<$<CONFIG:Release>:-ffunction-sections>
)

target_link_options(main PRIVATE
  $<$<CONFIG:Release>:-flto>
  $<$<CONFIG:$<OR:$<CONFIG:Release>,<CONFIG:RelWithDebInfo>>>:$<$<CXX_COMPILER_ID:GNU>:-Wl,--gc-sections>>
  $<$<CONFIG:$<OR:$<CONFIG:Release>,<CONFIG:RelWithDebInfo>>>:$<$<CXX_COMPILER_ID:Clang>:-dead_strip>>
)

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