编写和维护自动化测试时如何按测试金字塔分层…

当需要编写测试、搭建测试框架或提升测试覆盖率时，按单元/集成/E2E 三层组织测试并遵循规范。

适用场景

解决思路

1. 按测试金字塔组织测试：单元测试数量多、成本低、速度快；集成测试数量适中；E2E 测试数量少、成本高、速度慢。
2. 单元测试遵循四条原则：测试行为而非实现、通常每个测试一个断言、使用 Arrange-Act-Assert 模式、使用描述性测试名。
3. 单元测试示例（Jest）：用 describe/it 组织，先 Arrange 准备数据，再 Act 调用被测方法，最后 Assert 断言结果；对异常用 await expect(...).rejects.toThrow('Invalid email') 验证。
4. 集成测试遵循四条原则：测试组件间交互、对外部服务使用测试替身（test doubles）、清理测试数据、隔离运行。
5. 集成测试示例（Supertest）：用 request(app).post('/api/users').send({...}).expect(201) 发起请求并断言状态码与响应体字段。
6. E2E 测试遵循四条原则：只测关键用户流程、使用贴近真实的测试数据、正确处理异步操作、测试后清理。
7. E2E 测试示例（Playwright）：page.goto('/login')、page.fill('[name="email"]', ...)、page.click('button[type="submit"]')，再用 expect(page).toHaveURL('/dashboard') 和 expect(page.locator('h1')).toContainText('Welcome') 断言。
8. 覆盖率目标：行覆盖 > 80%、分支覆盖 > 75%、函数覆盖 > 80%、语句覆盖 > 80%。
9. 生成覆盖率报告：Jest 用 npm test -- --coverage；Python 用 pytest --cov=src --cov-report=html；Go 用 go test -coverprofile=coverage.out 再 go tool cover -html=coverage.out。
10. 最佳实践 DO：修复 bug 前先写测试（TDD）、测试边界情况、保持测试相互独立、使用描述性测试名、mock 外部依赖、清理测试数据。
11. 最佳实践 DON'T：不要测试实现细节、不要写脆弱的测试、不要无理由跳过测试、不要提交被注释掉的测试、不要测试第三方库。
12. 测试命名规范：用 'should reject invalid email addresses' 或 'returns 401 when user provides invalid credentials' 这类描述场景与结果的名称，避免 'works correctly' 这类含糊命名。
13. 常用框架与命令：TypeScript/JS 用 Jest、Vitest（npm test）；Python 用 pytest（pytest）；Go 用 testing（go test）；Java 用 JUnit（mvn test）；Rust 用内置（cargo test）。
14. 生成测试样板：运行 python3 scripts/generate_test.py --name <feature> --output tests/test-plan.md。
15. 检查测试覆盖率：运行 python3 scripts/coverage_report.py --name <service-name> --output coverage-report.md。
16. 参考文档：references/best-practices.md（测试最佳实践）、references/examples/（各框架示例）、references/mocking.md（mock 指南）。