维岳

第12课：重构的方法论

8 min read

重构的方法论

覆盖知识点：KP-037

经过前面几课的重构实战，我们已经接触了三种核心的重构手法。现在是时候把它们放到一起，提炼出一套系统的方法论了。

三种核心重构手法回顾

flowchart TD
    subgraph ”第2章：基础手法”
        A[”Extract Function<br/>提炼函数”]
    end
    
    subgraph ”第3章：进阶手法”
        B[”Assemble to Class<br/>组装成类”]
        C[”Replace Query<br/>for Variable<br/>查询替代变量”]
    end
    
    A --> B
    A --> C
    B --> D[”更清晰的代码结构”]
    C --> D

手法一：提炼函数（Extract Function）

将一段有明确目的的代码块提取为独立的函数，并用有意义的名称命名。

// 重构前
public double calculateTotal(Order order) {
    double subtotal = 0;
    for (Item item : order.getItems()) {
        subtotal += item.getPrice() * item.getQuantity();
    }
    double shipping = 20.0;
    return subtotal + shipping;
}
 
// 重构后
public double calculateTotal(Order order) {
    return calculateSubtotal(order) + calculateShipping(order);
}
 
private double calculateSubtotal(Order order) {
    return order.getItems().stream()
        .mapToDouble(item -> item.getPrice() * item.getQuantity())
        .sum();
}
 
private double calculateShipping(Order order) {
    return 20.0;
}

手法二：组装成类（Assemble to Class）

将散落但行为相似的函数归集到一个类中，从面向过程走向面向对象。

// 重构前：三个独立函数
double case1(Order order) { return 20.0; }
double case2(Order order) { /* 加急费计算 */ }
double case3(Order order) { /* 国际费计算 */ }
 
// 重构后：一个类
public class ShippingFeeCalculator {
    public double calculate(Order order, ShippingType type) {
        // 统一入口
    }
    private double normalFee(Order order) { return 20.0; }
    private double expressFee(Order order) { /* ... */ }
    private double internationalFee(Order order) { /* ... */ }
}

手法三：用查询替代变量（Replace Query for Variable）

将硬编码的字面量（魔法数字/字符串）替换为有意义的查询方法。

// 重构前
return 20.0;  // 20.0 是什么？
 
// 重构后
return normalShippingFee();  // 语义清晰

三种手法的对比

维度提炼函数组装成类查询替代变量
解决的问题方法过长/职责不单一函数散落/缺少组织魔法数字/意图不明确
重构粒度函数级别类级别表达式级别
核心动作提取 + 命名归集 + 封装替换 + 抽象
对测试的影响测试无变化测试需重新组织测试更语义化
适用阶段任何时候发现重复模式时代码出现魔法值时
后续演进可进一步组装成类可演化为策略模式可演化为配置查询

重构的节奏：小步快跑

重构最重要的心法不是”知道怎么做”，而是知道什么时候停，什么时候走。

每一步的节奏：

1. 识别坏味道          ← 观察（Observe）
     ↓
2. 应用重构手法         ← 操作（Act）
     ↓
3. 运行测试             ← 验证（Verify）
     ↓
4. 测试通过？           ← 决策（Decide）
    ├── 是 → 继续下一步
    └── 否 → 撤销上一步操作，重新思考

Quote

“重构的黄金法则是：每一步都小到可以随时回退。” —— 本课程讲师

flowchart LR
    S1[”步骤1<br/>提取方法”] --> T1[”测试通过?”]
    T1 -->|是| S2[”步骤2<br/>重命名”]
    T1 -->|否| R1[”回退”]
    
    S2 --> T2[”测试通过?”]
    T2 -->|是| S3[”步骤3<br/>提取常量”]
    T2 -->|否| R2[”回退”]
    
    S3 --> T3[”测试通过?”]
    T3 -->|是| Done[”完成”]
    T3 -->|否| R3[”回退”]
    
    R1 --> S1_2[”重新思考<br/>换一种方式”]
    R2 --> S1_2
    R3 --> S1_2
    S1_2 --> S1

重构与测试的关系

flowchart TD
    subgraph ”重构三要素”
        A[”识别坏味道”]
        B[”应用重构手法”]
        C[”运行测试验证”]
    end
    
    A --> B --> C
    
    C -->|”绿色”| A
    C -->|”红色”| D[”撤销回退”]
    D --> B

重构和测试形成了一种共生关系：

要素角色类比
测试安全网高空作业的安全绳
坏味道信号仪表盘上的警示灯
重构手法工具螺丝刀/扳手
小步提交节奏登山时的步伐

重构的"三步走"口诀

一看二改三验证：

  • 一看：发现代码坏味道
  • 二改：应用重构手法
  • 三验证：运行测试确认不破坏功能

什么时候不该重构？

重构虽然好，但不是万能的。以下情况应该暂缓重构：

  1. 没有测试保护 —— 重构的先决条件是存在测试
  2. 代码马上要重写 —— 既然要重写，不如直接写更好的版本
  3. 截止日期前 —— 交付功能优先，重构可以延后
  4. 不理解的代码 —— 先理解再重构，否则可能引入隐式 Bug

重构的禁忌

永远不要在没有测试的情况下重构生产代码。没有安全网的”重构”不叫重构，叫”重写”。

构建重构的”工具箱”

随着课程的推进，我们将不断往重构工具箱中添加新工具：

课次重构手法类型
第04课提炼函数基础
第07课用重构划定范围策略
第08课组装成类组织
第09课查询替代变量表达式
第19课用断言替代 if-else条件
第20课去除原始类型偏执类型
第21课用查询替代参数参数
第22课用管道替代循环迭代
第23课用函数表达意图命名
第24课多态取代条件条件

其他语言的等效实践

  • Python：Python 的函数是一等公民，提炼函数非常自然；通过类（class）和 @staticmethod 组织相关函数；@property 装饰器天然支持”查询替代变量”
  • Go：Go 的包（package）机制可以替代类来组织函数；接口（interface）支持查询方法的抽象；但 Go 没有类继承，组装成类更常用组合（composition）
  • JavaScript：模块（ES Module）可以归集相关函数；class 语法支持面向对象风格；使用函数或 getter 替代硬编码值
  • 本质：这套方法论跨语言通用，区别仅在于各语言的语法载体不同

重构方法论是本课程的”心法”核心。从第13课：测试的分类开始，我们将进入测试分类的全局视角——只有理解了不同类型测试的定位，才能知道在重构时该依赖哪些测试作为安全网。完整的重构手法可参考 重构手法速查表。

Graph View

Backlinks