zhaoxuya520 覆盖率报告（Coverage Reporting）
适用场景
- 覆盖率目标设定
- CI 覆盖率收集
- PR 覆盖率评论
- 覆盖率趋势跟踪
- 覆盖率门禁
核心原则
1. 覆盖率是基线不是目标
80% 覆盖率 ≠ 80% 质量
2. 关注增量覆盖率
新代码 ≥ 80%，比总覆盖率更有意义
3. 不追求 100%
getter / setter / 配置不需要测
4. 分层看
业务逻辑 ≥ 90%
Controller ≥ 60%
工具函数 ≥ 80%
5. 趋势比绝对值重要
覆盖率不能下降
工具
| 工具 | 语言 | 用途 |
|---|---|---|
| Codecov | 多语言 | SaaS 报告 + PR 评论 |
| Coveralls | 多语言 | SaaS 报告 |
| SonarQube | 多语言 | 自建 + 质量门禁 |
| Istanbul / c8 | JS/TS | 收集器 |
| JaCoCo | Java | 收集器 |
| coverage.py | Python | 收集器 |
| go test -cover | Go | 内置 |
覆盖率目标
| 层 | 目标 | 说明 |
|---|---|---|
| Domain / Service | ≥ 90% | 核心业务 |
| Controller | ≥ 60% | 集成测试覆盖 |
| Utils | ≥ 80% | 工具函数 |
| 总体 | ≥ 70% | 基线 |
| 增量（新代码） | ≥ 80% | PR 门禁 |
CI 集成
# Vitest 覆盖率
- run: pnpm test:coverage
- uses: codecov/codecov-action@v4
with:
files: coverage/lcov.info
fail_ci_if_error: true
# 门禁：覆盖率不能下降
- name: Coverage check
run: |
COVERAGE=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
if (( $(echo "$COVERAGE < 70" | bc -l) )); then
echo "Coverage below threshold: $COVERAGE%"
exit 1
fi
配套模板
templates/coverage-config-template.md— 覆盖率配置 + 目标 + CI
质量自检
□ 覆盖率目标设定
□ CI 自动收集
□ PR 评论（增量）
□ 门禁（不能下降）
□ 趋势跟踪
□ 分层目标
□ 不追求 100%
常见坑
- 追求 100%——测 getter 浪费时间
- 只看总覆盖率——新代码 0% 也能过
- 不设门禁——覆盖率持续下降
- 覆盖率 = 质量——覆盖了不等于测对了
- 不看趋势——单点数据无意义
与其他 skill 的协作
上游：
unit/integration/e2e → 测试代码产生覆盖率
下游：
ci-test-integration → CI 收集
qa-engineer quality-gate → 门禁条件