项目中模块库无法链接单元测试，是否有更简便的CMake方案？

阿华AIGC实验室

2026-5-8

解决MODULE库无法在单元测试中链接的问题

你遇到的问题很典型：CMake的MODULE类型库是设计用于动态加载（比如通过dlopen）的，不能直接链接到可执行文件，所以测试程序没法直接关联这类目标。你当前用克隆库的方法确实容易遗漏关键属性，比如INTERFACE层面的编译选项、定义等，导致测试环境和生产环境不一致。

下面是两种更简便、可靠的解决方案：

方法一：根据测试开关切换库类型

直接通过构建选项控制库的类型，当开启测试时，把库改成STATIC或SHARED（这两种类型可以正常链接到可执行文件），发布时再用MODULE类型：

option(BUILD_TESTING "Build unit tests" OFF)

# 根据是否构建测试选择库的类型
set(FOO_LIB_TYPE MODULE)
if(BUILD_TESTING)
    set(FOO_LIB_TYPE STATIC)
endif()

add_library(foo ${FOO_LIB_TYPE} foo.h foo.cpp)
target_link_libraries(foo PUBLIC bar::bar)
install(TARGET foo DESTINATION bin)
target_include_directories(foo PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

# 仅在测试模式下构建测试程序
if(BUILD_TESTING)
    add_executable(foo_tester fooTester.cpp)
    target_link_libraries(foo_tester foo)
    add_test(NAME foo_tester COMMAND foo_tester)
endif()

这种方式逻辑简单，不需要额外的复杂操作，能保证测试时的库和生产库的编译配置完全一致。

方法二：用OBJECT库作为核心复用层

先把所有源文件打包成OBJECT类型库（这是CMake里专门用于复用编译产物的目标类型），然后基于它分别构建生产用的MODULE库和测试用的可链接库：

# 核心OBJECT库，包含所有业务代码和依赖配置
add_library(foo_obj OBJECT foo.h foo.cpp)
target_link_libraries(foo_obj PUBLIC bar::bar)
target_include_directories(foo_obj PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
# 这里可以添加所有需要的编译选项、定义等，都会自动传递给下游目标

# 构建生产用的MODULE库
add_library(foo MODULE)
target_sources(foo PRIVATE $<TARGET_OBJECTS:foo_obj>)
install(TARGET foo DESTINATION bin)

# 测试部分
if(BUILD_TESTING)
    # 基于OBJECT库创建一个可链接的STATIC库用于测试
    add_library(foo_test STATIC)
    target_sources(foo_test PRIVATE $<TARGET_OBJECTS:foo_obj>)
    # 继承OBJECT库的依赖（因为OBJECT库的PUBLIC属性会自动传递）
    target_link_libraries(foo_test PUBLIC foo_obj)

    add_executable(foo_tester fooTester.cpp)
    target_link_libraries(foo_tester foo_test)
    add_test(NAME foo_tester COMMAND foo_tester)
endif()

这种方式的优势是完全复用核心代码的配置，不会遗漏任何属性，而且结构清晰，适合复杂项目的扩展。