初始化

This commit is contained in:
2026-03-05 21:27:11 +08:00
commit 130de0fd5d
140 changed files with 21972 additions and 0 deletions

View File

@@ -0,0 +1,65 @@
---
description: >
Vue 3 + Vitest 前端测试技能。新建或更新测试文件、
编写单元/组件/E2E 测试时激活。
globs:
- "**/*.test.*"
- "**/__tests__/**"
alwaysApply: false
---
# Vue Testing
> 本文件是精简执行摘要。完整流程、模板和深度参考见:
> Read `.cursor/skills/vue-testing/SKILL.md`
> **适用性**:本技能用于**新建或更新测试文件**。
> 非测试相关的代码修改可忽略本技能。
## 测试决策树(每次写测试前必须先走)
```
纯转换逻辑parse/format/validate/compute→ 提取到 .utils.tsVitest 单元测试
涉及复杂 UI 交互 → Vue Test Utils 组件测试
能提取为纯函数或 composable → 提取后写单元测试
跨页面流程、关键业务路径 → Playwright E2E
```
## 测试类型
| 类型 | 工具 | 文件命名 |
|------|------|---------|
| 单元测试 | Vitest | *.test.ts |
| 组件测试 | Vitest + Vue Test Utils | *.test.ts |
| E2E | Playwright | *.spec.ts |
## 核心原则
1. **逻辑提取** — 业务逻辑提取到 .utils.ts 纯函数
2. **穷举排列** — 有效/无效/空值/边界/安全输入
3. **AAA 模式** — Arrange-Act-Assert
4. **单一行为** — 每个 it() 只验证一个行为
5. **命名** — `should <行为> when <条件>`
## 增量式工作流
工具函数 → Composables → 简单组件 → 复杂组件 → 集成。
逐个文件:写测试 → vitest run → PASS 才下一个。
## 覆盖率目标
Function 100% | Statement 100% | Branch > 95% | Line > 95%
## 验证
- [ ] 走过决策树
- [ ] 逻辑已提取到 .utils.ts
- [ ] 穷举排列覆盖
- [ ] 命名 should...when...
- [ ] vitest run 全部通过
- [ ] 覆盖率达标
## 深度参考
- `.cursor/skills/vue-testing/references/testing-templates.md`
- `.cursor/skills/vue-testing/references/mock-patterns.md`