CMake中控制链接器库顺序、避免重复及自定义静态库名问题

问题1：静态库名称自动添加额外lib前缀 #

当你定义静态库时，如果目标名是libA，CMake默认会给库名加上lib前缀，最终生成liblibA.a。要显式指定库名称，有两种实用方式：

• 针对单个库设置输出名称：在定义库之后，用set_target_properties指定OUTPUT_NAME属性，直接覆盖默认命名逻辑：

  # 示例：生成名为libA.a的静态库
  add_library(libA STATIC src/a.cpp)
  set_target_properties(libA PROPERTIES OUTPUT_NAME "A")
  

  这里把OUTPUT_NAME设为A，CMake会自动加上默认的lib前缀，最终得到libA.a；如果不需要任何前缀，也可以全局禁用默认前缀（不推荐全局修改，除非所有库都需要）：

  set(CMAKE_STATIC_LIBRARY_PREFIX "")
  add_library(libA STATIC src/a.cpp) # 直接生成libA.a
  

• 简化目标命名：直接用不带lib的目标名定义库，CMake会自动添加前缀生成标准命名的静态库：

  add_library(A STATIC src/a.cpp) # 生成libA.a
  

问题2：链接时库重复、依赖顺序错误 #

核心原因 #

CMake会自动追踪目标的依赖关系，当你链接main到libA时，会自动把libA的依赖库加入链接列表；如果MAIN_LIBRARIES中也包含libA，就会导致重复链接。另外，CMake默认的链接顺序会把自动追加的依赖库放在你指定的MAIN_LIBRARIES之后，破坏依赖顺序要求。

解决方案 #

1. 避免重复链接+强制MAIN_LIBRARIES在链接末尾

• 清理重复依赖：检查MAIN_LIBRARIES，确保其中不包含已经通过target_link_libraries链接到main的库（比如libA）。
• 强制控制链接顺序：
  • 用SHELL:前缀包裹MAIN_LIBRARIES，让CMake原封不动地将其放在链接命令的最后，不插入自动追加的依赖：

    target_link_libraries(main PRIVATE libA "$<SHELL:${MAIN_LIBRARIES}>")
    

  • 或者设置main目标的LINK_LAST属性，让所有指定的链接库排在链接命令末尾：

    set_target_properties(main PROPERTIES LINK_LAST ON)
    target_link_libraries(main PRIVATE ${MAIN_LIBRARIES} libA)
    

2. 禁用CMake自动追加依赖库

如果需要完全手动控制链接列表，不让CMake自动追踪依赖：

• 使用LINK_ONLY修饰符：链接库时加上该修饰符，告诉CMake只链接库本身，不处理其依赖：

  target_link_libraries(main PRIVATE $<LINK_ONLY:libA> ${MAIN_LIBRARIES})
  

• 直接指定库文件路径：跳过CMake的目标依赖追踪，直接传入静态库的绝对路径：

  target_link_libraries(main PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/libA.a ${MAIN_LIBRARIES})
  

3. 解决重复链接问题

如果重复链接是因为MAIN_LIBRARIES包含重复项，可以先去重：

list(REMOVE_DUPLICATES MAIN_LIBRARIES)
target_link_libraries(main PRIVATE libA ${MAIN_LIBRARIES})

也可以通过链接器选项忽略重复库（以GCC为例）：

target_link_options(main PRIVATE "-Wl,--as-needed")

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