跳转至

测试覆盖率

分析测试覆盖率,识别缺口并生成缺失的测试,以达到 80%+ 的覆盖率。

步骤 1:检测测试框架

指标 覆盖率命令
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
pom.xml 包含 JaCoCo mvn test jacoco:report
go.mod go test -coverprofile=coverage.out ./...

步骤 2:分析覆盖率报告

  1. 运行覆盖率命令
  2. 解析输出(JSON 摘要或终端输出)
  3. 列出覆盖率低于 80% 的文件,按从最差到最好排序
  4. 对于每个低于目标的文件,识别:
  5. 未测试的函数或方法
  6. 缺失的分支覆盖(if/else、switch、错误路径)
  7. 使分母膨胀的死代码

步骤 3:生成缺失的测试

对于每个低于目标的文件,按以下优先级生成测试:

  1. 正常路径 — 使用有效输入的主要功能
  2. 错误处理 — 无效输入、缺失数据、网络故障
  3. 边界情况 — 空数组、null/undefined、边界值(0、-1、MAX_INT)
  4. 分支覆盖 — 每个 if/else、switch 分支、三元表达式

测试生成规则

  • 将测试放在源代码旁边:foo.ts → foo.test.ts(或项目约定)
  • 使用项目现有的测试模式(导入风格、断言库、mock 方法)
  • 对外部依赖进行 mock(数据库、API、文件系统)
  • 每个测试必须独立 — 测试之间不共享可变状态
  • 以描述性方式命名测试:test_create_user_with_duplicate_email_returns_409

步骤 4:验证

  1. 运行完整测试套件 — 所有测试必须通过
  2. 再次运行覆盖率 — 确认改进
  3. 如果仍低于 80%,对剩余缺口重复步骤 3

步骤 5:报告

显示前后对比:

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

重点领域

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

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 ev/ECC