如何缩小CTest可执行文件体积？多测试用例共享代码方案咨询

1. 跨平台C++测试框架推荐 #

• Google Test（GTest）：当前最主流的C++单元测试框架之一，支持把所有测试用例统一编译到单个可执行文件中，无需为每个测试单独生成二进制文件，从根源避免公共代码重复链接的问题。CTest可以直接对接GTest的测试用例过滤参数，单独运行任意指定测试。
• Catch2：轻量易用的单头文件测试框架，同样支持多测试用例合并编译，语法更简洁，适合中小型项目快速迁移。
  上述两类框架都兼容Windows、Linux、macOS三大平台，和CMake/CTest生态完全适配。

2. CTest下单元测试公共代码共享方法 #

方案A：合并测试用例编译（最推荐） #

不用为每个测试单独生成可执行文件，将所有测试cpp文件都编译进同一个测试主程序：

add_executable(AllTests Test1.cpp Test2.cpp Test3.cpp ...)
target_link_libraries(AllTests PRIVATE BigClass)

如果需要单独运行单个测试用例，配合测试框架的过滤参数在CTest中注册即可，以GTest为例：

# 单独注册First、Second两个测试用例
add_test(NAME First COMMAND AllTests --gtest_filter=Test1.*)
add_test(NAME Second COMMAND AllTests --gtest_filter=Test2.*)

该方案下所有测试仅链接一次BigClass代码，总二进制体积只会比单个测试多几KB的测试逻辑代码，完全解决重复占用空间的问题。

方案B：修复动态库链接配置 #

你之前动态库不生效大概率是平台的符号导出规则限制，修复后即可正常共享动态库代码：

1. 优先删除之前编译的静态链接的Test1、Test2缓存文件，避免旧产物干扰。
2. 按照下文第三部分的动态链接操作配置，完成后测试可执行文件体积会降到KB级，所有测试共享一份BigClass动态库。

3. C++类动态链接具体操作指引 #

第一步：代码侧添加导出导入标记 #

在BigClass.h中添加如下宏定义：

// 区分编译动态库和引用动态库的场景
#ifdef _WIN32
    #ifdef BIG_CLASS_COMPILE_DLL
        #define BIG_CLASS_API __declspec(dllexport)
    #else
        #define BIG_CLASS_API __declspec(dllimport)
    #endif
#else
    #define BIG_CLASS_API __attribute__((visibility("default")))
#endif

// 要导出的类需要加BIG_CLASS_API标记
class BIG_CLASS_API BigClass {
    // 原有类定义不变
};

第二步：CMake配置修改 #

add_library(BigClass SHARED ../path/to/BigClass.cpp)
# 编译动态库时添加宏定义，标记为导出
target_compile_definitions(BigClass PRIVATE BIG_CLASS_COMPILE_DLL)
# 开启位置无关代码，兼容动态库要求
set_target_properties(BigClass PROPERTIES POSITION_INDEPENDENT_CODE ON)

# 测试链接配置不变
target_link_libraries(Test1 PRIVATE BigClass)
target_link_libraries(Test2 PRIVATE BigClass)

第三步：运行适配 #

• Windows下需要把BigClass.dll和测试可执行文件放在同一目录，或者把dll所在目录加入PATH环境变量才能运行测试。
• Linux/macOS下确认CMAKE_MACOSX_RPATH配置开启，运行时会自动搜索同目录下的动态库。

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