CLion测试调试需关注四方面：错误定位要展开堆栈查源码行号；区分断言失败与运行时异常；mock失效需检查路径一致性、声明位置及动态import处理；调试器失效应验证CMake类型、Vitest路径和sourceMap配置。
查看测试输出和堆栈跟踪
测试失败时，CLion 会在 运行 工具窗口中直接展示错误位置、断言信息和完整堆栈。关键不是只看第一行红字，而是展开 Caused by 或 at ... 行——它指明了实际出错的源码行号（比如 at mytest.spec.ts:42:15），而非测试框架内部调用。
常见误区是忽略「断言失败」和「运行时异常」的区别：
- 断言失败（如
expect(x).toBe(42)不成立）：只显示比较结果，无堆栈，说明逻辑或输入有误 - 运行时异常（如
TypeError: Cannot read property 'id' of undefined）：一定带堆栈，需检查被测函数是否收到预期参数，或 mock 是否遗漏返回值
如果堆栈里出现 node_modules/ 路径，说明问题在依赖行为变更（比如 Vitest 升级后 vi.mock 默认作用域变化），不是你自己的代码逻辑问题。
Vitest 测试中 mock 未生效的典型表现
mock 失效时，测试常报错 Cannot find module 'xxx' 或调用真实模块并抛出意外异常（如真实 HTTP 请求失败）。根本原因通常是模块解析路径与 vi.mock 声明不一致。
必须确保：
-
vi.mock('fs')中的字符串，和你import语句里的路径完全相同（包括大小写、斜杠方向、是否带.js后缀） -
vi.mock必须放在文件顶部顶层作用域，不能包裹在describe或函数内 - 若被测模块使用动态
import()，需用vi.doMock替代vi.mock，并在beforeEach中重置
验证 mock 是否加载成功：在测试中加一行 console.log(require('fs'))，运行后看输出是否为你的 mock 对象，而不是原生 fs 模块。
调试器进不去测试代码的配置盲区
点击装订区域的 调试 图标后程序直接跑完、断点变灰色（unresolved），大概率不是代码问题，而是构建或调试符号没对齐。
重点检查三项：
- CMake 构建类型必须是
Debug（Settings → Build → CMake → CMAKE_BUILD_TYPE=Debug），Release下所有调试信息被剥离 - CLion 的
Run → Edit Configurations → Vitest配置中，Node.js interpreter必须指向项目根目录下的node_modules/.bin/vitest，而非全局安装的vitest—— 否则调试器无法映射源码 - TypeScript 项目要确认
tsconfig.json含"sourceMap": true且"outDir"与 CLion 中设置的编译输出路径一致
一个快速验证法：在测试文件中加 debugger 语句，运行 vitest --inspect，用 Chrome DevTools 连接，如果能停住，说明是 CLion 调试集成配置问题，不是代码本身。
测试通过但结果不可靠的隐藏陷阱
有些测试看似绿色通过，实则因异步处理不当而漏检问题。典型症状是：本地快、CI 上偶尔失败；或修改无关代码后测试突然挂掉。
重点关注：
- Promise 或定时器未正确
await：Vitest 默认不等待未await的 Promise，测试会提前结束。必须显式await所有异步操作，包括vi.advanceTimersByTime() - 全局状态污染：多个测试共用同一个对象引用（如
const config = { debug: true }），前一个测试改了它，后一个测试读到脏数据。应确保每个test内部重新构造依赖对象 - 时间敏感断言：用
Date.now()或new Date()做断言时，未用vi.useFakeTimers()控制时间流，导致结果随系统时钟漂移
最危险的是「侥幸通过」——比如 mock 返回固定值恰好满足断言，但没覆盖真实分支。建议打开 CLion 的 Code | Inspect Code，启用 Unused symbol 和 Possible side effect in test 类检查，主动暴露这类脆弱点。
