CLion测试功能需框架集成、CMake配置与运行配置三者对齐，缺一不可；否则TEST_CASE等仅被识别为普通函数，装订区无▶图标，无法运行或显示在测试视图中。
CLion 的测试功能不是“开箱即用就全好使”的，它依赖框架集成、CMake 配置和运行配置三者对齐；漏掉任意一环，TEST_CASE 或 test("foo") 就只会被当成普通函数，点不了运行图标，也进不了测试视图。
为什么点不了装订区的 ▶ 图标？常见断连点
这是最常卡住用户的一步。CLion 不会自动识别任意含测试宏的文件——它只响应已被 CMake（或 Vite/Karma）明确声明为“测试目标”的可执行/入口模块。
- 对 C++：确认
CMakeLists.txt中已用add_executable(tests ...)+target_link_libraries(tests PRIVATE gtest_main)（或catch2等）声明测试目标，且该目标未被set_property(TARGET tests PROPERTY EXCLUDE_FROM_ALL TRUE)隐藏 - 对 TypeScript/JS：确认项目根目录有
vitest.config.ts或karma.conf.js，且 CLion 已检测到（检查右下角状态栏是否有 Vitest/Karma 图标） - 即使语法正确，若文件未被 CMake target 的
sources列表包含，或未在package.json的testscript 中被引用，装订区也不会出现运行图标
CTest 与 Google Test/Catch2 配置的区别在哪
很多人以为选了 “Google Test” 运行配置就能跑 Catch2，结果报错 Test executable not found。根本区别在于：CTest 是 CMake 原生测试驱动，而 Google Test/Catch2 是 IDE 对特定框架的 UI 封装——它们读取的是不同层级的元信息。
- CTest 配置：只认 CMake 的
enable_testing()+add_test()定义，不关心你用什么断言库；适合已有成熟 CMake 测试结构的项目 - Google Test / Catch2 配置：绕过 CMake 的
add_test，直接扫描二进制输出中符合框架签名的测试用例（如TEST_F符号），要求可执行文件必须链接对应框架的 main 入口（如CATCH_CONFIG_MAIN） - Doctest 和 Boost.Test 同理，但 Doctest 默认不导出符号表，需加编译选项
-DDOCTEST_CONFIG_IMPLEMENT_WITH_MAIN才能被 CLion 自动识别
临时配置 vs 永久配置：什么时候必须保存
每次点击装订区 ▶ 生成的都是临时配置，关掉 IDE 就消失。但某些场景下不保存会直接失效：
- 需要传参时：比如
--gtest_filter=MySuite.*或--tag=[integration]，这些参数只能在永久配置的Program arguments字段里设置，临时配置不提供编辑入口 - 需要固定 Node.js 版本时：Vitest/Karma 配置若依赖特定
node_modules路径（如 pnpm workspace），临时配置可能随机选错解释器，导致Cannot find module 'vitest' - 调试时断点失效：临时配置无法保存
Environment variables（如VITEST_RUN_MODE=debug），而某些框架依赖环境变量触发调试模式
测试树里显示“unknown”或跳过不运行
这通常不是代码问题，而是 CLion 没拿到足够上下文来解析测试结构。尤其在跨语言混合项目（如 C++ CLI + JS 测试胶水）中高频出现。
- 对 C++：检查是否启用了
Run tests using: CTest但实际没调用add_test()；此时强制切换成Run tests using: Google Test（即使不用 GTest）反而能解析出用例 - 对 Vitest：确保
vitest.config.ts中type: 'e2e'没被误设，CLion 目前只支持type: 'unit'的自动发现 - 路径含中文或空格：CMake 生成的测试路径若含空格（如
build/test suite），CTest 解析会截断，改用下划线命名或在 CMake 中用set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$:Debug>")显式控制
最易被忽略的点：CLion 的测试视图默认只监听“当前运行配置”对应的二进制输出。如果你改了 CMakeLists.txt 增加新测试 target，但没重建整个 build 目录，旧的缓存二进制仍会被加载——此时要手动执行 Build | Clean 再 Build | Build Project，否则新增的 TEST_CASE 永远不会出现在树里。
