如何让VSCode测试面板按目录结构展示CMake+GTest测试用例

要让VSCode测试面板按你的目录结构展示GTest测试，有两种实用的配置方式，结合起来效果最佳：

1. 给测试用例添加层级式命名 #

在测试代码里，给测试用例名称带上目录模块前缀，用下划线分隔，VSCode测试面板会自动识别并生成树形结构。

比如maths_tests.cpp里的测试：

TEST(maths_Addition, PositiveNumbers) {
    ASSERT_EQ(2 + 3, 5);
}

TEST(maths_Subtraction, NegativeResult) {
    ASSERT_EQ(2 - 3, -1);
}

util_tests.cpp里的测试：

TEST(util_StringTrim, LeadingWhitespace) {
    ASSERT_EQ(trim("  hello"), "hello");
}

TEST(util_FileRead, NonExistentFile) {
    ASSERT_THROW(read_file("not_exists.txt"), std::runtime_error);
}

配置后，面板里会自动生成maths和util两个父节点，下面分别对应各自的测试用例。

2. 通过CMake给测试目标设置分组标签 #

在每个子测试目录的CMakeLists.txt中，使用gtest_discover_tests时给测试添加LABELS属性，明确指定层级分组。

比如base/tests/my_tests/maths/CMakeLists.txt：

add_executable(maths_tests maths_tests.cpp)
target_link_libraries(maths_tests GTest::gtest_main)

# 给maths模块的测试设置标签
gtest_discover_tests(maths_tests
    PROPERTIES
        LABELS "maths"
)

base/tests/my_tests/util/CMakeLists.txt：

add_executable(util_tests util_tests.cpp)
target_link_libraries(util_tests GTest::gtest_main)

# 给util模块的测试设置标签
gtest_discover_tests(util_tests
    PROPERTIES
        LABELS "util"
)

如果需要更细的嵌套层级（比如maths/algebra），可以把LABELS设为"maths/algebra"，VSCode会自动创建嵌套节点。

3. 确认VSCode测试面板的树形模式 #

打开VSCode的设置，确保以下选项开启：

"cmake.testExplorerTreeMode": "hierarchical",
"cpp.unitTest.gtest.treeMode": "hierarchical"

这一步通常默认已配置，若之前修改过可以检查确认。

完成以上配置后，重新生成CMake缓存并编译测试，VSCode测试面板就会按照你的目录结构展示所有测试用例了。

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