如何通过CMake将库私有链接至外部静态库

要实现静态库B完全包含依赖的静态库A，使得链接B的可执行文件或其他库无需再链接A，核心是将A的目标文件合并到B的归档文件中，而非仅通过CMake的依赖声明关联两者。

问题根源 #

静态库本质是目标文件（.o）的归档集合，CMake中target_link_libraries(B_B PRIVATE A)仅记录B对A的符号依赖，但链接器生成可执行文件时，仍会列出所有依赖的静态库来解析符号，因此你会看到B_main的链接命令中同时出现libB_B.a和A.a。

解决方案1：合并预编译静态库A到B中（适用于A是外部预编译库的情况） #

通过CMake自定义命令，在B构建完成后，将A的目标文件提取并合并到B的静态库中：

修改B/CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.15.0)

project(B LANGUAGES CXX)

# 声明外部预编译静态库A
add_library(A STATIC IMPORTED)
target_include_directories(A INTERFACE ../A)
set_target_properties(A PROPERTIES IMPORTED_LOCATION ${PROJECT_SOURCE_DIR}/../A/A.a)

# 构建B的静态库
add_library(B_B STATIC)
target_sources(B_B PRIVATE B.cpp)
target_link_libraries(B_B PRIVATE A)
# 对外暴露B的头文件目录
target_include_directories(B_B PUBLIC ${PROJECT_SOURCE_DIR})

# 自定义命令：合并A.a到B_B.a
add_custom_command(TARGET B_B POST_BUILD
    # 解压A.a得到所有目标文件
    COMMAND ${CMAKE_AR} x $<TARGET_FILE:A>
    # 将解压出的.o文件追加到B_B.a中
    COMMAND ${CMAKE_AR} rcs $<TARGET_FILE:B_B> *.o
    # 清理临时生成的.o文件
    COMMAND ${CMAKE_COMMAND} -E remove *.o
    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
)

# 测试可执行文件
add_executable(B_main main.cpp)
target_link_libraries(B_main PUBLIC B_B)

关键步骤说明：

• ${CMAKE_AR}：CMake自动适配平台的归档工具（Linux/macOS用ar，Windows可能用lib.exe）
• POST_BUILD：确保在B_B库构建完成后执行合并操作
• 先解压A的目标文件，再将其合并到B的归档中，最终清理临时文件

解决方案2：用OBJECT库整合A的源码（适用于能访问A源码的情况） #

如果可以获取A的源码，直接将A声明为OBJECT库，CMake会自动把A的目标文件包含到依赖它的静态库B中，无需手动合并：

修改B/CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.15.0)

project(B LANGUAGES CXX)

# 将A作为OBJECT库编译（需要A的源码）
add_library(A OBJECT ../A/A.cpp)
target_include_directories(A PUBLIC ../A)

# 构建B的静态库，链接A的OBJECT目标
add_library(B_B STATIC)
target_sources(B_B PRIVATE B.cpp)
target_link_libraries(B_B PRIVATE A)
target_include_directories(B_B PUBLIC ${PROJECT_SOURCE_DIR})

# 测试可执行文件
add_executable(B_main main.cpp)
target_link_libraries(B_main PUBLIC B_B)

这种方式更简洁，OBJECT库的目标文件会直接嵌入到B的静态库中，下游链接时仅需引用B即可。

验证效果 #

重新执行构建命令后，查看链接输出，会发现仅使用libB_B.a，不再出现A.a，且B_main能正常运行，A的符号完全被隐藏在B中。

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