重构案例模板

# [重构标题]
 
## 背景
 
什么代码、什么问题、为什么要重构。
 
## 问题描述
 
- 代码异味：大函数（500 行）、重复代码、循环依赖
- 影响：难以维护、难以测试、新人上手慢
- 触发原因：要加新功能，发现改不动
 
## 重构策略
 
### 策略选择
 
选择了「渐进式重构」，而不是「大规模重写」。
 
理由：
- 大规模重写风险太高，需要停机
- 渐进式重构可以逐步验证，随时回滚
- 团队没有大规模重写的经验
 
### 重构步骤
 
#### 步骤 1：添加测试（第 1-2 天）
 
- 给现有功能添加单元测试
- 覆盖率从 20% 提升到 60%
- 确保重构不会破坏功能
 
#### 步骤 2：提取函数（第 3-5 天）
 
- 把 500 行的大函数拆成 10 个小函数
- 每个小函数 < 50 行
- 保持外部接口不变
 
#### 步骤 3：消除重复（第 6-7 天）
 
- 找到 3 处重复代码
- 提取为公共函数
- 用测试验证行为一致
 
#### 步骤 4：改善模块边界（第 8-10 天）
 
- 把循环依赖改为单向依赖
- 引入接口层解耦
- 更新测试
 
## 测试策略
 
- 重构前先添加测试，覆盖率 > 60%
- 每个步骤完成后运行测试
- 发现测试失败立即回滚
 
## 结果
 
重构耗时 2 周，按计划完成：
 
- 代码行数：500 行 → 10 个函数，每个 < 50 行
- 重复代码：3 处 → 0 处
- 测试覆盖率：20% → 75%
- 新人上手时间：3 天 → 1 天
 
## 复盘
 
- 测试先行是正确的，重构过程中发现了 2 个隐藏 bug
- 渐进式重构风险可控，但耗时比预期长
- 重构后代码可读性明显提升，新功能开发速度加快
- 后续行动：建立代码异味检查清单，定期审查