CMake实战：如何为多组件测试复用单个test_main.cpp文件

完全不用复制文件！在monorepo里复用单个test_main.cpp其实有几个很简便的CMake技巧，我在多个项目里都试过，给你分享两种最实用的方法：

方法1：将test_main封装为对象库（推荐） #

这是最干净且高效的方式，把test_main.cpp做成一个可复用的对象库，只编译一次，所有测试目标只需要链接这个对象就行。

步骤如下：

1. 在monorepo根目录创建一个专门的测试公共目录（比如test_common），把你的test_main.cpp放在这里。
2. 在根目录的CMakeLists.txt（或者test_common目录的专属CMakeLists.txt）里定义对象库：

# 先确保已找到Catch2依赖
find_package(Catch2 REQUIRED)

# 创建对象库，仅编译test_main.cpp一次
add_library(test_main OBJECT test_common/test_main.cpp)

# 给对象库关联Catch2的头文件路径，依赖它的测试目标会自动继承
target_link_libraries(test_main PUBLIC Catch2::Catch2)

# 设置统一的C++标准，确保和所有测试组件的编译标准一致
target_compile_features(test_main PUBLIC cxx_std_17)

3. 然后在每个组件的测试目录的CMakeLists.txt里，创建测试可执行文件时链接这个对象库：

# 组件自身的测试源文件
set(TEST_SOURCES
    component_a_test.cpp
    utils_test.cpp
)

# 创建测试可执行文件，只需指定组件测试源+链接test_main对象库
add_executable(component_a_test ${TEST_SOURCES})
target_link_libraries(component_a_test PRIVATE test_main)

# （可选）如果组件有自己的业务库，也一并链接
target_link_libraries(component_a_test PRIVATE component_a_core)

# 注册到CTest（如果用CTest管理测试的话）
add_test(NAME component_a_test COMMAND component_a_test)

方法2：直接引用共享的test_main.cpp路径 #

如果不想额外维护对象库，也可以在每个测试目标里直接引用根目录的test_main.cpp绝对路径，CMake会自动处理编译，完全不需要复制文件：

find_package(Catch2 REQUIRED)

set(TEST_SOURCES
    component_b_test.cpp
)

# 直接把共享的test_main.cpp加入测试可执行文件的源列表
add_executable(component_b_test ${TEST_SOURCES} ${PROJECT_SOURCE_DIR}/test_common/test_main.cpp)

target_link_libraries(component_b_test PRIVATE Catch2::Catch2 component_b_core)
add_test(NAME component_b_test COMMAND component_b_test)

一些注意事项 #

• 不管用哪种方法，都要确保所有测试目标的编译选项（比如C++标准、警告等级）和test_main的一致，避免出现链接或运行时问题。
• 如果使用Catch2 v3版本，API略有变化，但复用test_main的思路完全相同，只需把find_package(Catch2 REQUIRED)改成find_package(Catch2 3 REQUIRED)即可。
• 如果你是用CMake的FetchContent引入Catch2，记得在定义test_main之前先完成Catch2的拉取和配置，确保头文件路径可用。

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