GoogleTest无法识别C++项目单元测试问题求助

你的测试程序找不到测试用例，核心问题是测试文件被编译成静态库后，链接器会将未被直接引用的静态初始化代码（GTest的TEST宏注册逻辑）优化剔除。GTest的测试用例是通过全局对象的构造函数完成注册的，这些对象的构造代码属于“未被显式调用”的代码，链接器默认会认为它们是无用代码而移除，导致RUN_ALL_TESTS()找不到任何注册的测试。

下面提供两种可行的修复方案，推荐第一种（直接将测试文件编译进可执行文件），更简单且避免链接器优化问题：

方案1：直接将测试文件加入测试可执行文件 #

修改MyProject/CMakeLists.txt，不再创建测试库，而是将测试文件路径导出到顶层CMake：

add_library(MyProject_core file_manager.cpp word_randomizer.cpp speed_gauge.cpp logging.cpp)

if(buildTests)
    # 定义测试文件列表并导出到父作用域
    set(unit_test_files file_manager.test.cpp speed_gauge.test.cpp tests_common.test.cpp word_randomizer.test.cpp)
    set(MyProject_unit_test_files ${unit_test_files} PARENT_SCOPE)
endif()

修改顶层CMakeLists.txt中的测试可执行文件部分，把测试文件直接加入源文件列表：

add_executable(MyProjectTestsExe "MyProject/test_runner.cpp" ${MyProject_unit_test_files})
set_necessary_compile_options(MyProjectTestsExe)
target_link_libraries(MyProjectTestsExe GTest::gtest_main MyProject_core)

这样测试文件会直接编译进测试可执行文件，静态初始化的测试注册代码不会被链接器优化，RUN_ALL_TESTS()就能找到所有测试用例。

方案2：保留测试库，禁用链接器死代码消除 #

如果你坚持要将测试文件做成静态库，需要强制链接器包含整个测试库的内容，避免优化掉测试注册代码：

修改顶层CMakeLists.txt中的target_link_libraries部分，根据编译器添加链接选项：

target_link_libraries(MyProjectTestsExe GTest::gtest_main MyProject_core)

# 强制链接整个测试库，避免优化掉测试注册代码
if(UNIX)
    target_link_libraries(MyProjectTestsExe -Wl,--whole-archive MyProject_unit_tests -Wl,--no-whole-archive)
elseif(MSVC)
    target_link_libraries(MyProjectTestsExe /WHOLEARCHIVE:MyProject_unit_tests)
endif()

• 确认所有测试文件中正确包含了<gtest/gtest.h>头文件
• 确认TEST/TEST_F宏的写法正确（如TEST(FileManagerTest, ReadFileSuccess)），没有拼写错误
• 编译测试时未定义NDEBUG宏（部分环境下NDEBUG会导致GTest禁用测试注册，可在测试目标中添加target_compile_definitions(MyProjectTestsExe PRIVATE -DDEBUG)确保）

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