hello-test

测试相关代码必须遵循以下规范。

编码前

先列出被测模块的关键行为和边界条件，设计测试用例，再写测试代码。

TDD 流程（强制）

新功能和 Bug 修复必须遵循红-绿-重构循环：

1. 红 — 写描述期望行为的测试，运行确认失败
2. 绿 — 写最少的代码让测试通过
3. 重构 — 清理代码，保持测试通过

如果测试写完就直接通过了，说明测试没有验证新行为——重新审视测试。

豁免场景（标记 [-] 说明原因即可）：

• 纯 UI 样式调整（无逻辑变更）
• 配置文件修改
• 文档/注释变更
• 快速原型探索（用户明确要求）

除豁免场景外，没有先写测试 = 不能写实现代码。

覆盖策略

• 核心业务逻辑：单元测试必覆盖
• API 端点：集成测试覆盖主要路径（成功 + 主要失败场景）
• 关键用户流程：E2E 测试覆盖
• Bug 修复：先写失败测试，再修复（红-绿验证）

测试编写

• 测试名描述行为：should reject expired tokens，不是 test token
• AAA 模式：Arrange（准备）→ Act（执行）→ Assert（断言）
• 每个测试独立，不依赖执行顺序
• Mock 外部依赖（数据库/API/文件系统），不 mock 被测代码本身

边界用例（必须覆盖）

• 空值：null / undefined / 空字符串 / 空数组
• 边界值：0、-1、MAX_INT、超长字符串
• 错误路径：无效输入、网络超时、权限不足
• 并发：竞态条件（如果适用）

测试质量

• 避免脆弱测试：不依赖时间、随机数、外部服务
• 测试数据用 factory/fixture，不硬编码
• 断言具体值，不只断言"不为空"
• 一个测试验证一个行为

交付检查

• 核心逻辑有单元测试
• 测试名描述行为
• 覆盖了主要边界用例
• 测试可独立运行