CLion运行单元测试需正确配置CMake测试目标和框架模板：必须用add_test()注册、选对Google Test/Catch/Doctest模板、确保可执行目标链接正确，否则测试不显示或无法运行。
CLion 里跑单元测试，关键不是“会不会”，而是“配不配得对”——配错框架类型、选错可执行目标、漏掉 CMake 链接，测试根本不会出现在运行列表里，更别说绿色勾或红色叉了。
为什么 Run ▶ 按了没反应，或者报 Test target not found
这是最常卡住人的第一步。CLion 不会自动把任意可执行文件当测试运行，它只认“被明确标记为测试目标”的 CMake target。
- 确保你的
CMakeLists.txt中用add_test()显式注册了测试，例如：add_test(NAME MyTest COMMAND MyTestExecutable) - 如果你用的是 Google Test，必须链接
gtest_main或自己提供main()，且目标需通过target_link_libraries(MyTestExecutable gtest_main)关联 - 别依赖“直接运行可执行文件”来触发测试框架逻辑——那样只会跑
main()，不会触发TEST()或TEST_F()的自动发现 - 改完
CMakeLists.txt后，务必点右下角的Reload project（或按Ctrl+Shift+O），否则 CLion 还在用旧的构建图
Google Test / Catch2 / Doctest 配置选哪个？
选错模板，图标变灰、右键菜单不出现“Run Test”，甚至 Ctrl+Shift+R 也不识别测试函数。
- Google Test：选
Google Test模板，不是CMake Application；确保项目已find_package(GTest REQUIRED)并正确target_link_libraries - Catch2：选
Catch模板（注意不是Catch2—— CLion 当前模板名仍为Catch）；入口必须是CATCH_CONFIG_MAIN或自定义main()调用Catch::Session().run() - Doctest：选
Doctest模板；确认源文件包含DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN或已提供main() - 所有框架都要求：测试可执行目标不能是
SHARED或STATIC库，必须是EXECUTABLE
测试能跑但不显示树形结构，或断点不生效
这说明 CLion 没拿到测试元数据，只当普通进程跑了。
- 检查运行配置的
Target是否指向你真正的测试可执行文件（不是all或install） - 在配置的
Program arguments栏里，不要手动加--gtest_filter=*等参数——CLion 的测试视图依赖原生输出格式，加了参数反而破坏解析 - 调试测试时，必须用
Debug 'xxx'（装订区小虫图标），不能用Run+ 手动 attach —— 后者进不了测试框架的初始化流程 - 如果用了
gtest_main，确保没重复定义main()，否则链接失败，配置图标带红叉
CTest 和框架原生配置混用会怎样？
CTest 是 CMake 自带的测试驱动，CLion 会自动检测并创建 CTest 类型配置；但它和 Google Test 等框架配置互斥，不能共存于同一目标。
- 如果你在
CMakeLists.txt中同时写了add_test()和链接gtest_main，CLion 可能创建两个配置：一个CTest（只显示“1 test passed”）、一个Google Test（带完整树形和断点） - 优先用框架原生配置（
Google Test等）——它支持单测跳转、失败重跑、夹具生命周期可视化；CTest配置仅适合批量回归或 CI 场景 - 删掉
add_test()并专注用框架宏定义测试，能避免 IDE 解析歧义
真正容易被忽略的，是 CMake target 名称和实际可执行文件名是否一致——CLion 从 add_executable(mytest ...) 推导名称，但如果你在 add_test() 里写的是 add_test(NAME MyTest COMMAND my_test)（下划线 vs 小驼峰），IDE 就找不到对应二进制，连配置都创建不出来。
