📊 测试覆盖率指南

Jest Coverage Metrics 详解

覆盖率的四种计算口径

Jest 测试覆盖率使用 Istanbul (nyc) 作为底层引擎，提供4种不同维度的覆盖率指标：

各口径详解

// 这是 1 行，但包含 2 个语句
let x = 1; let y = 2;

// 这是 1 行 1 语句
const sum = x + y;

// 有 2 个分支：if 为真 和 if 为假
if (user.isAdmin) {
  grantAccess();    // 分支 1
} else {
  denyAccess();     // 分支 2
}

// 三元运算符也有 2 个分支
const status = isActive ? 'active' : 'inactive';

// switch 语句每个 case 都是一个分支
switch (type) {
  case 'A': ... // 分支 1
  case 'B': ... // 分支 2
  default: ...  // 分支 3
}

// 只要这个函数被调用一次，函数覆盖率就是 100%
function calculateTotal(items) {
  if (items.length === 0) return 0;  // 分支可能未覆盖
  return items.reduce((sum, i) => sum + i.price, 0);
}

项目配置的覆盖率阈值

后端配置 backend/jest.config.js

coverageThreshold: {
  global: {
    branches: 60,
    functions: 60,
    lines: 60,
    statements: 60
  }
}

前端配置 frontend/web_app/jest.config.js

coverageThreshold: {
  global: {
    branches: 70,
    functions: 70,
    lines: 70,
    statements: 70
  }
}

如何查看覆盖率报告

命令行查看

# 后端覆盖率
cd backend && npm run test:coverage

# 前端覆盖率
cd frontend/web_app && npm run test:coverage

# 根目录快捷命令（后端+前端）
npm run test:coverage

HTML 报告（推荐）

运行覆盖率测试后，会在 coverage/ 目录生成 HTML 报告：

# 打开后端覆盖率报告
open backend/coverage/lcov-report/index.html

# 打开前端覆盖率报告
open frontend/web_app/coverage/lcov-report/index.html

输出示例

-----------------------------|---------|----------|---------|---------|
File                         | % Stmts | % Branch | % Funcs | % Lines |
-----------------------------|---------|----------|---------|---------|
All files                    |   85.23 |    72.15 |   91.45 |   85.67 |
 services/                   |   92.34 |    84.21 |   95.00 |   92.56 |
  auditLogger.js             |   97.05 |    76.47 |  100.00 |  100.00 |
  checkinService.js          |  100.00 |    87.69 |  100.00 |  100.00 |
  invoiceService.js          |  100.00 |    98.21 |  100.00 |  100.00 |
-----------------------------|---------|----------|---------|---------|

哪个指标最重要？

// 示例：语句覆盖 100%，分支覆盖 50%
function getDiscount(customer) {
  if (customer.isVip) {
    return 0.2;  // ✅ 被测试了
  }
  return 0;      // ❌ 从未被测试！
}

// 只写了这个测试
test('VIP gets 20% discount', () => {
  expect(getDiscount({ isVip: true })).toBe(0.2);
});

CI 门禁检查

项目配置了 .github/workflows/ci-test.yml 在 PR 时自动检查覆盖率：

• 后端覆盖率低于 60% 会阻止合并
• 前端覆盖率低于 70% 会阻止合并
• 新增 API/Service 文件必须有对应测试

🧪 统一测试系统 (Unified Test Runner)

项目提供统一测试运行器，可一次性运行所有子项目的测试，覆盖 465+ 个测试文件：

测试文件统计

统一测试命令

# 日常自检（推荐）- 后端 + 前端 + Landing
npm run test:all

# 快速测试（提交前）- 仅单元测试
npm run test:all:quick

# 完整测试（发布前）- 含 Flutter 移动端
npm run test:all:full

# CI 模式 - 含覆盖率报告
npm run test:all:ci

# 按测试类型
npm run test:all:unit         # 仅所有单元测试
npm run test:all:integration  # 仅所有集成测试
npm run test:all:e2e          # 仅所有 E2E 测试

脚本参数详解

直接调用脚本 ./scripts/test-all.sh [options] 支持更多选项：

测试报告目录

test-reports/
├── backend/                   # 后端测试报告
│   ├── unit/
│   ├── integration/
│   ├── api/
│   └── sync/
├── frontend/                  # 前端测试报告
│   ├── unit/
│   └── e2e/
├── landing/                   # Landing Page 测试报告
├── flutter/                   # 移动端测试报告
│   ├── guest-app/
│   └── employee-app/
└── summary/                   # 汇总报告
    └── latest.md              # 最新汇总报告（符号链接）

cat test-reports/summary/latest.md

Flutter E2E 测试命令

Guest App 的 Flutter E2E 测试也可以单独运行：

# 运行所有 Flutter E2E 测试
npm run test:flutter

# 按模块运行
npm run test:flutter:auth       # 认证流程
npm run test:flutter:booking    # 预约流程
npm run test:flutter:cart       # 购物车流程
npm run test:flutter:appointments # 预约列表
npm run test:flutter:account    # 账户/设置
npm run test:flutter:config     # AppConfig 动态配置