架构与系统设计 / 系统课时

把重构过程控制在安全边界

把重构过程控制在安全边界

模式重构真正危险的地方不是改动多,而是改完后难以确认行为是否保持。要把测试保护、渐进替换和可回退点串起来,让每一步都有证据、有边界,发现问题时可以迅速回到上一个稳定状态。

学习目标

  • 建立“先保护、再替换、后删除”的重构节奏
  • 使用自动化测试和小步提交验证行为保持
  • 为高风险改动设计可回退的边界

先定义什么不能变

安全重构首先不是决定使用哪一种模式,而是明确外部行为。对于已有业务代码,调用方真正依赖的往往包括返回值、异常、持久化结果、事件发送时机,以及关键副作用。

可以先把稳定契约写成测试,再开始内部重构。测试不一定覆盖所有实现细节,但至少应锁定本次改动不能破坏的业务结果。

重构安全边界与回退路径

用测试建立可观测的基线

测试保护的重点是让重构前后可以做对照。优先补业务层和接口层的高价值用例,例如同一输入得到相同结果、非法输入仍抛出预期异常、关键副作用仍然发生。

例如原代码计算订单折扣,先固定当前公开行为,再替换内部实现。下面是一个独立可运行的 Python 示例,用断言表示重构前后的稳定契约。

python
def calculate_discount(total: float, vip: bool) -> float:
    if total < 0:
        raise ValueError("total must be non-negative")
    return total * 0.90 if vip else total


def test_discount_behavior() -> None:
    assert calculate_discount(100, True) == 90
    assert calculate_discount(100, False) == 100

    try:
        calculate_discount(-1, False)
    except ValueError as exc:
        assert str(exc) == "total must be non-negative"
    else:
        raise AssertionError("expected ValueError")


if __name__ == "__main__":
    test_discount_behavior()
    print("tests passed")

预期输出

text
tests passed

采用渐进替换而不是一次重写

重构过程中可以暂时保留旧路径,让新实现先在少量调用点承担职责。每次只移动一个结构性变化,例如先提取接口,再替换一个调用,再删除一个重复分支。

一个实用边界是“单次改动只回答一个问题”:接口是否仍然满足原契约、替换后结果是否一致、异常是否一致。这样失败时可以准确定位到最近一次变化,而不是在一大片 diff 中猜原因。

为每一步保留回退点

安全重构不等于永远不出错,而是出错后代价可控。建议把每个已经验证通过的阶段形成清晰提交,并避免把行为变化、格式化和大规模无关整理混在同一次提交中。

当测试失败时,先判断是预期中的结构变化还是行为回归。结构调整可以继续修复;行为回归则应优先恢复到最近稳定点,再缩小改动范围。不要为了“让测试重新变绿”而直接修改测试,除非业务契约本身已经确认发生变化。

什么时候可以删除旧实现

只有当新路径已经接管全部调用、关键测试稳定,并且没有运行期配置或兼容入口继续依赖旧实现时,才适合删除旧代码。删除本身也应作为独立小步骤,方便审查和回退。

最终的安全边界可以概括为:先建立行为证据,再小步改变结构;每一步都验证,并始终保留回到稳定状态的路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把重构过程控制在安全边界

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通