CLion单元测试支持需项目正确集成测试框架并配置构建系统；若CMakeLists.txt未注册测试目标、未启用enable_testing()或运行配置选错，IDE将无法识别、运行或调试测试。
CLion 对单元测试的支持不是“开箱即用”的魔法，而是依赖你项目中是否已正确集成测试框架并配置了 CMake（或构建系统）。没有 gtest、Catch2、Boost.Test 或 Vitest 的实际代码和构建规则，CLion 就无法识别、运行或调试任何测试。
确认你的 CMakeLists.txt 是否已注册测试目标
CLion 的测试运行器只响应 CMake 中显式声明的测试目标。常见错误是：写了 TEST() 宏，但没在 CMakeLists.txt 里调用 add_executable 并链接对应库。
- 对 Google Test，必须有类似这样的配置：
add_executable(my_tests test_main.cpp string_utils_test.cpp) target_link_libraries(my_tests gtest gtest_main)
且该 target 名称不能与主可执行文件重复；否则 CLion 会忽略它。
- 使用
catkin_add_gtest（ROS 场景）时，确保CATKIN_ENABLE_TESTING为ON，且该命令出现在if(CATKIN_ENABLE_TESTING)块内；否则 CMake 不生成测试 target。 - 手动添加
enable_testing()是必须的，否则ctest和 CLion 的 CTest 支持不会激活。
装订区域图标不出现？先检查测试函数签名和宏
CLion 仅在编辑器左侧装订区显示运行/调试图标，前提是它能静态识别出这是“一个测试”。这取决于你使用的框架和写法。
-
Google Test：函数必须用TEST()、TEST_F()、TEST_P()等宏定义，且宏调用必须在全局作用域（不能在 namespace 内直接写，除非用GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST等特殊处理）。 -
Catch2：需以TEST_CASE("name")或带标签的TEST_CASE("name", "[tag]")开头；SCENARIO、WHEN等 BDD 风格宏也支持，但嵌套过深可能被 IDE 漏识别。 -
Boost.Test：必须使用BOOST_AUTO_TEST_CASE，而不是手写的int test_foo() { ... }；后者不会触发图标渲染。 - 如果用了
main()自定义入口（比如某些旧版 gtest 示例），CLion 会完全无视——它只认框架自动注册的测试单元。
运行配置选错会导致“点击无反应”或“找不到测试”
CLion 提供两类测试运行入口：通用可执行文件运行方式（Run → Run 'xxx'）和专用测试配置（Run → Edit Configurations... → Google Test / Catch / Vitest）。二者行为差异极大。
- 选通用可执行配置，只会跑
main()函数，不解析内部测试结构，也不会展示树状测试视图或失败堆栈定位。 - 选
Google Test配置后，CLion 会调用my_tests --gtest_list_tests探测可用测试，并允许你按名称、标签或正则筛选运行；但前提是你的可执行文件确实支持--gtest_list_tests参数（即链接了gtest_main或自己实现了main调用RUN_ALL_TESTS()）。 -
Vitest配置必须指定正确的Node.js解释器路径；若项目用 pnpm +vitest二进制，需在Test file pattern中填**/*.test.{ts,js}，否则默认只扫**/test/**下的文件。
CTest 集成最容易被忽略的两个前提
如果你希望 CLion 直接识别 ctest 命令发现的测试（例如 ROS 或大型 CMake 项目），光有 add_test() 不够。
- 必须在根
CMakeLists.txt中调用enable_testing()，否则 CMake 不生成CTestTestfile.cmake，CLion 就读不到任何测试列表。 -
add_test()的第一个参数（测试名）必须是纯标识符（如string_utils_test），不能含空格或路径字符；否则 CLion 解析失败，测试不显示。 - 运行时若报错
No tests were found，打开终端执行cd build && ctest -N，看输出是否列出测试；没列出就说明 CMake 层根本没注册成功，IDE 层再怎么点都无效。
最常卡住的地方不是语法写错，而是 CMake 构建逻辑和 IDE 运行配置之间的映射断开了——CLion 不会替你修复缺失的 target_link_libraries 或漏掉的 include_directories，它只忠实地反映 CMake 已知的内容。
