单元测试

单元测试到底难在哪

写测试的人经常遇到三种困境：一是函数和组件耦合太深，想测一个纯逻辑却要连带 localStorage、fetch 和一整套组件树；二是 mock 范围失控，vi.mock() 把整个模块替换掉之后，测试通过但真实行为没人验证；三是覆盖率数字很好看，branches 却只有 40%，回归照样悄悄溜进来。

这个技能把 Vitest 的测试编写整理成一套可执行的工作流，目标是产出可读、可维护、能防回归的测试代码，而不是一堆只证明「代码没崩」的断言。

核心能力与关键步骤

• 范围识别：区分纯函数、React/Vue 组件与异步逻辑，各自匹配不同的断言策略，且只测公开接口与用户可见行为，不去碰 private 方法或内部 state。
• 结构约束：统一采用 Arrange → Act → Assert 模式，用 describe 分组，用 it.each 做参数化覆盖正常值、边界值与异常值。
• 分层 mock：按优先级依次考虑不 mock、vi.fn()、vi.spyOn()、vi.mock()、MSW。优先测试运行时行为而不是替换实现，避免过度 mock。
• 覆盖率落地：在 vitest.config.ts 里配置 include/exclude 与 thresholds，建议 statements 80%、branches 70%，配合 vitest run --coverage 让 CI 在不达标时直接失败。

适用边界

不适用于端到端流程验证（交给 playwright-e2e）或接口契约校验（交给 testing-api-contract）。如果你发现某个函数很难写出测试，通常说明模块耦合有问题，技能会同时给出重构方向而不是强行补 mock。已有测试代码也可以作为输入，用于质量审查。