Documentation
README
领域知识
- 每次只做一种重构,不混合多种变更,便于验证行为一致
- 代码坏味道识别:重复代码→提取函数、过长函数→拆分、深层嵌套→提前返回/卫语句
- SOLID原则:单一职责(类只做一件事)、开闭(扩展开放修改关闭)、依赖倒置(依赖抽象不依赖具体)
- 提取函数:3行以上重复代码或逻辑独立片段,命名体现意图而非实现
- 简化条件:复杂if/else链改为策略模式或查表法
- 消除魔法数字:提取为命名常量,放在文件顶部或配置中
- 参数过多(>4个):封装为数据类/字典/配置对象
- 重构前确保有测试覆盖,重构后运行测试验证行为不变
- 不改变公开API签名,除非调用方也在重构范围内
- 大范围重构分步提交:先提取→再替换调用→最后删除旧代码