/test-coverage

测试覆盖率 (Test Coverage)

分析测试覆盖率（Test Coverage），识别覆盖缺口，并补全缺失的测试以达到 80% 以上的覆盖率。

步骤 1：检测测试框架 (Test Framework)

| 指标 (Indicator) | 覆盖率命令 (Coverage Command) | |-----------|-----------------| | `jest.config.*` 或 `package.json` 中的 jest | `npx jest --coverage --coverageReporters=json-summary` | | `vitest.config.*` | `npx vitest run --coverage` | | `pytest.ini` / `pyproject.toml` 中的 pytest | `pytest --cov=src --cov-report=json` | | `Cargo.toml` | `cargo llvm-cov --json` | | 包含 JaCoCo 的 `pom.xml` | `mvn test jacoco:report` | | `go.mod` | `go test -coverprofile=coverage.out ./...` |

步骤 2：分析覆盖率报告 (Coverage Report)

1. 运行覆盖率命令 2. 解析输出结果（JSON 摘要或终端输出） 3. 列出 **覆盖率低于 80%** 的文件，按覆盖率从低到高排序 4. 针对每个覆盖不足的文件，识别以下内容：

• 未测试的函数或方法
• 缺失的分支覆盖（if/else、switch、错误路径）
• 导致分母虚高的死代码（Dead Code）

步骤 3：生成缺失的测试

针对每个覆盖不足的文件，按以下优先级生成测试：

1. **正常路径 (Happy Path)** —— 使用有效输入的中心功能 2. **错误处理 (Error Handling)** —— 无效输入、缺失数据、网络故障 3. **边界情况 (Edge Cases)** —— 空数组、null/undefined、边界值 (0, -1, MAX_INT) 4. **分支覆盖 (Branch Coverage)** —— 每个 if/else、switch 分支、三元运算符

测试生成规则

• 测试文件需与源码相邻：`foo.ts` → `foo.test.ts`（或遵循项目惯例）
• 使用项目现有的测试模式（导入风格、断言库、Mock 方案）
• 对外部依赖进行 Mock（数据库、API、文件系统）
• 每个测试应保持独立 —— 测试之间不共享可变状态
• 采用描述性命名：`test_create_user_with_duplicate_email_returns_409`

步骤 4：验证 (Verify)

1. 运行完整测试套件 —— 所有测试必须通过 2. 重新运行覆盖率检查 —— 验证改进效果 3. 如果仍低于 80%，对剩余缺口重复步骤 3

步骤 5：报告 (Report)

显示前后对比：

Coverage Report
──────────────────────────────
File                   Before  After
src/services/auth.ts   45%     88%
src/utils/validation.ts 32%    82%
──────────────────────────────
Overall:               67%     84%  ✅

重点关注领域

• 具有复杂分支的函数（高圈复杂度）
• 错误处理程序和 catch 代码块
• 在整个代码库中使用的工具函数
• API 接口处理程序（请求 → 响应流）
• 边界情况：null、undefined、空字符串、空数组、零、负数