如何基于测试名称自定义CTest属性与标签？

问题核心 #

gtest_discover_tests的TEST_LIST变量是测试发现阶段动态生成的，并非CMake配置阶段的全局变量，所以你在主CMakeLists.txt或CTestCustom.cmake中直接访问不到。要对已发现的测试做自定义操作，需要利用CMake的测试发现钩子机制。

可行解决方案 #

1. 简单场景：直接通过TEST_PROPERTIES配置 #

如果测试名称有固定规律（比如统一前缀/后缀），可以在gtest_discover_tests调用中直接指定属性：

gtest_discover_tests(MyTestTarget
  TEST_LIST MyTests
  # 给所有测试统一加标签
  TEST_PROPERTIES LABELS "UnitTest"
)

这种方式适合批量设置通用属性，无法做复杂的名称匹配逻辑。

2. 灵活场景：自定义Post-Discovery脚本 #

利用POST_DISCOVERY_SCRIPT参数指定一个CMake脚本，在测试发现完成后执行，此时可以直接访问TEST_LIST变量：

步骤1：主CMakeLists.txt配置

gtest_discover_tests(MyTestTarget
  TEST_LIST DiscoveredTests
  # 指定发现后执行的脚本
  POST_DISCOVERY_SCRIPT "${CMAKE_CURRENT_SOURCE_DIR}/post_discovery.cmake"
)

步骤2：编写post_discovery.cmake脚本

在这个脚本里可以遍历测试列表，根据名称设置属性：

foreach(test_name IN LISTS DiscoveredTests)
  # 给包含"Integration"的测试添加集成测试标签
  if(test_name MATCHES "Integration")
    set_tests_properties(${test_name} PROPERTIES LABELS "IntegrationTest")
  endif()
  # 给长耗时测试设置超时
  if(test_name MATCHES "LongRunning")
    set_tests_properties(${test_name} PROPERTIES TIMEOUT 300)
  endif()
endforeach()

该脚本会在测试发现完成后自动执行，DiscoveredTests变量在此上下文完全可用。

3. CTestCustom.cmake的局限性 #

CTestCustom.cmake主要用于定制CTest的全局行为（如预/后测试命令），无法直接遍历已发现的测试列表。如果一定要基于它实现，只能通过CTEST_CUSTOM_POST_TEST调用外部脚本间接处理，但复杂度远高于方案2，不推荐。

关键提示 #

• TEST_LIST仅在POST_DISCOVERY_SCRIPT的执行上下文有效，CMake配置阶段无法访问，因为测试发现是生成CTest测试文件时才完成的。
• 确保POST_DISCOVERY_SCRIPT的路径正确，优先使用绝对路径或CMAKE_CURRENT_SOURCE_DIR拼接路径，避免路径问题。

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