cursor-vitest

Cursor IDE 的 Vitest 规则 1. **测试文件命名** - 使用 `.test.js`、`.test.ts`、`.spec.js` 或 `.spec.ts` 后缀（例如：`utils.test.ts`）。 - 推荐统一团队采用 `.test.*` 或 `.spec.*` 风格，避免混用。 2. **测试结构** - 使用 `describe()` 组织测试套件，`it()` 或 `test()` 定义单个用例。 - 示例： ```ts describe('add function', () => { it('should return sum of two numbers', () => { expect(add(1, 2)).toBe(3); }); }); ``` 3. **断言风格** - 优先使用 Vitest 的链式断言（如 `expect().toBe()`），避免手动 `if/throw`。 - 对异步代码使用 `await` + `resolves`/`rejects`： ```ts await expect(fetchData()).resolves.toEqual({ ok: true }); ``` 4. **Mock 规范** - 使用 `vi.fn()` 创建模拟函数，`vi.mock()` 模拟模块。 - 明确标注模拟用途（如 `// Mock API response`）。 5. **快照测试** - 谨慎使用 `toMatchSnapshot()`，大对象建议拆分或自定义匹配器。 - 定期审查快照更新（`--updateSnapshot`）。 6. **配置与钩子** - 在 `vitest.config.ts` 中集中配置（覆盖率、环境变量等）。 - 使用 `beforeEach`/`afterEach` 清理状态，避免测试间污染。 7. **性能优化** - 标记慢速测试：`it.skip` 或 `it.todo` 临时禁用问题用例。 - 并行运行测试（默认启用），避免全局状态依赖。 8. **类型安全** - TypeScript 项目中启用严格模式，确保测试代码类型正确。 9. **CI/CD 集成** - 添加 `--reporter=verbose` 输出详细结果，失败时退出码非零。 10. **文档注释** - 为复杂测试逻辑添加注释说明场景和预期行为。 > 💡 提示：通过 Cursor 的 AI 功能快速生成测试模板（输入 `// test for [function]` 触发建议）。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本