如何通过CMake将多个C++测试源文件合并编译？

核心思路：用条件编译控制Boost.Test的main生成 #

Boost.Test的BOOST_TEST_MODULE宏会自动生成main函数，这是合并编译时冲突的根源。我们可以通过条件编译宏让单个测试文件在单独编译时生成main，合并编译时禁用自动main，同时保留测试套件的注册。

1. 修改测试文件的头部代码 #

给每个测试源文件（如A.cpp、B.cpp）添加以下条件编译逻辑：

// 合并编译时禁用自动生成main
#ifdef COMBINED_TESTS
#define BOOST_TEST_NO_MAIN
#endif

// 单独编译时定义测试模块（自动生成main）
#ifndef BOOST_TEST_MODULE
#define BOOST_TEST_MODULE A_Tests  // 每个文件替换成对应的模块名，比如B_Tests
#endif

#include <boost/test/unit_test.hpp>

// 原有的测试套件和用例保持不变
BOOST_AUTO_TEST_SUITE(A_Suite)
BOOST_AUTO_TEST_CASE(Test1) {
    // 测试逻辑
}
BOOST_AUTO_TEST_SUITE_END()

2. 编写合并编译的入口文件 #

新建一个combined_main.cpp，提供合并测试的统一main入口：

#include <boost/test/unit_test.hpp>

int main(int argc, char* argv[]) {
    // 调用Boost.Test的测试入口
    return boost::unit_test::unit_test_main(&init_unit_test, argc, argv);
}

3. 配置CMake脚本 #

在CMakeLists.txt中同时支持单独编译单个测试和合并编译所有测试：

# 依赖Boost.Test
find_package(Boost REQUIRED COMPONENTS unit_test_framework)

# 收集所有测试源文件
set(TEST_SOURCES A.cpp B.cpp C.cpp)

# 1. 单独编译每个测试文件（保留原有能力）
foreach(TEST_FILE ${TEST_SOURCES})
    get_filename_component(TEST_NAME ${TEST_FILE} NAME_WE)
    add_executable(${TEST_NAME}_test ${TEST_FILE})
    target_link_libraries(${TEST_NAME}_test PRIVATE Boost::unit_test_framework)
endforeach()

# 2. 合并编译所有测试（提升编译效率）
add_executable(all_tests combined_main.cpp ${TEST_SOURCES})
# 给合并目标添加编译宏，禁用每个测试文件的自动main
target_compile_definitions(all_tests PRIVATE COMBINED_TESTS)
target_link_libraries(all_tests PRIVATE Boost::unit_test_framework)

# 可选：启用链接时间优化（LTO）进一步提升编译/运行效率
set(CMAKE_INTERPROCEDURAL_OPTIMIZATION ON)

关键说明 #

• BOOST_TEST_NO_MAIN：告诉Boost.Test不要自动生成main函数，避免多个main冲突。
• COMBINED_TESTS：自定义宏，用来区分单独编译和合并编译的场景。
• 合并编译时，所有测试套件会自动注册到统一的测试入口下，运行all_tests可执行文件时，会执行所有测试用例，也可以通过命令行参数指定运行某个套件（如./all_tests --run_test=A_Suite）。

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