CLion 正确识别测试需满足：项目集成对应框架、CMakeLists.txt/package.json 声明依赖、测试文件含框架宏（如TEST()）、装订区出现▶图标；否则仅运行普通可执行文件。
CLion 执行测试程序不依赖外部终端命令，而是通过内置的测试运行器驱动，关键在于配置类型是否匹配测试框架 —— 用错配置模板，Run 按钮只会启动普通可执行文件，不会识别测试用例。
怎么判断当前测试能被 CLion 正确识别
CLion 能自动检测并激活测试运行器，前提是项目已正确集成测试框架且 CMakeLists.txt 或 package.json 中声明了对应依赖。常见信号包括：
- 测试文件（如
test_main.cpp）中包含TEST()（Google Test）、TEST_CASE()（Catch2）或describe()（Vitest）等框架宏/函数 - 项目根目录存在
CMakeLists.txt并调用了find_package(GTest)或enable_testing()（CTest） - JavaScript/TypeScript 项目中
package.json的devDependencies包含vitest，且测试文件以.test.ts或.spec.ts结尾 - 编辑器左侧装订区域出现
▶图标（悬停显示 “Run test”），而不是灰色的“Run file”
执行单个测试最直接的方式
不用进菜单、不手动建配置，只要图标亮了就能点。但要注意：这个操作默认使用临时配置，每次改参数都要重设。
- 把光标放在某个
TEST()、it()或test()块内，或直接点击其左侧装订区的▶图标 - 从弹出菜单选
Run 'xxx'（不是Run 'xxx executable'） - 若首次运行且未配置 Node.js 运行时（Vitest）或 GTest 库路径（C++），会弹窗提示补全；此时必须填对，否则后续所有测试都报
Module not found或undefined reference to testing::InitGoogleTest - 运行结果出现在底部
Run工具窗口，失败时会高亮错误行，并带堆栈跳转箭头
为什么加了参数却没生效
测试框架本身不读取 Program arguments 字段 —— 那是给 main() 可执行文件用的。测试参数必须走框架约定方式传递：
- Google Test：在运行配置的
Program arguments中填--gtest_filter=MySuite.MyCase或--gtest_repeat=3，CLion 会透传给gtest二进制 - Catch2：用
-t "tag_name"或--list-tests，参数同样填在Program arguments，但需确认 CMake 目标链接的是catch2而非裸main - Vitest：不走
Program arguments，而是在 Vitest 配置的Environment variables中设VITEST_TEST_NAME=xxx，或在package.json的scripts里定义"test:unit": "vitest --run --testNamePattern='login'" - 误把测试当普通程序运行时，
argv会传给测试框架的主函数，而非你的业务逻辑，导致argc异常或解析失败
临时配置 vs 永久配置的实际影响
点装订区图标默认创建临时配置，它不保存参数、环境变量或工作目录设置，关掉 IDE 就丢。真正需要稳定执行（比如 CI 本地复现、持续 TDD）时，必须升为永久配置：
- 运行一次后，在顶部
Run工具栏的配置名称旁点▼→Save Configuration - 或打开
Run | Edit Configurations，找到刚用过的那个半透明图标配置，选中后点左上角磁盘图标 - 保存后图标变实心，名称可重命名（如
UnitTests-GoogleTest-Debug），下次直接从下拉菜单选，参数和标签过滤全部保留 - 注意：临时配置上限默认为 5 个，超出后旧的会被自动清理，容易误删正在调试的配置
最易被忽略的一点：CLion 的测试运行器只响应“被 CMake 或构建系统明确注册为测试目标”的可执行文件。如果只是把测试代码写进一个普通 add_executable() 而没调用 add_test() 或 gtest_discover_tests()，即使语法正确，图标也不会出现，Run 按钮永远只跑 main。
