Cannot find module 'vitest'是CLion未找到Vitest包所致，根源在于Node.js解释器路径未指向项目node_modules下对应版本，需在运行配置中确认解释器、检查package.json依赖、刷新解释器列表，并适配pnpm/yarn安装路径。
CLion 里测试报错，先别急着改代码——90% 的情况是环境没对上，或者配置漏了一环。
运行 Vitest 测试时提示 Cannot find module 'vitest'
这是最常见的启动失败，本质是 CLion 没找到 Vitest 包。它不看你终端里 npm install 成没成功，只认当前配置的 Node.js 解释器下的 node_modules 路径。
- 打开
Run | Edit Configurations，选中你的 Vitest 配置，在Node interpreter下拉框里确认选的是项目根目录下node_modules/.bin/vitest所在的 Node 版本（不是系统全局 Node） - 如果用了 pnpm 或 yarn，确保
node_modules已生成：在项目根目录终端执行pnpm install或yarn install，再刷新 CLion 的 Node.js 解释器列表（点击解释器右侧的刷新图标） - 检查
package.json中devDependencies是否真有"vitest"，且版本 >= 1.0.0（旧版 CLion 对 v0.x 支持不稳定）
Catch2 测试编译失败，报 undefined reference to 'main'
这个错误不是代码写错了，而是链接阶段缺了 Catch2 的入口实现。CLion 默认不会自动把 CATCH_CONFIG_MAIN 宏展开进最终可执行文件。
- 确保只有一个源文件（比如
test_main.cpp）里定义了#define CATCH_CONFIG_MAIN，且这行必须在#include "catch_amalgamated.hpp"之前 - 在
CMakeLists.txt中，把包含该main的文件显式加进add_executable，不要只加测试用例文件 - 如果用了
add_test+ctest方式，需额外设置set_target_properties(your_test_target PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/tests)，否则 CLion 可能找不到可执行体
测试通过但调试断点不生效，或报 Command timed out
这不是测试框架的问题，是 CLion 调试器和 GDB/LLDB 之间的握手超时。尤其在大型测试或带 I/O 的测试里很常见。
- 按
Ctrl+Shift+A打开Find Action，搜Registry，找到cldr.debugger.timeout，把值从默认30000改成120000（2 分钟） - 检查测试二进制是否启用了调试符号：CMake 中确认有
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g")，且没有-O2之类优化覆盖掉-g - 避免在
SECTION或TEST_CASE内部做耗时操作（如网络请求、大文件读取），这类逻辑应抽离到 fixture 或 mock 中
CLion 显示测试图标为灰色，不识别 TEST_CASE 或 it
图标灰掉 ≠ 测试不能跑，而是 CLion 没识别出这是测试结构。它依赖语言注入和测试框架插件双重支持。
- 确认已启用
Catch2或Vitest插件：进入Settings | Plugins，搜索并勾选对应插件（Vitest 插件名是JavaScript and TypeScript自带，Catch2 需单独安装） - 检查文件后缀：Vitest 测试必须是
.ts/.js/.tsx；Catch2 必须是.cpp/.cc，且文件名含test或spec（如math_test.cpp） - 右键测试文件 →
Override File Type→ 选JavaScript或C++，强制语言识别
最常被忽略的一点：CLion 的测试识别严重依赖 CMakeLists.txt 或 vite.config.ts 的正确性。哪怕一个路径拼错、一个 target 名称不匹配，都会导致测试图标消失或运行失败——它不会报错，只会沉默地不干活。
