AI Agent / 系统课时

安全重构代码

安全重构代码

本课解决“代码结构需要改善,但一改命名或拆方法就担心行为变化”的问题。你将先固定外部契约,再让 Claude Code 通过小步修改、持续测试和差异审查完成安全重构。

学习目标

  • 区分重构目标与功能变更
  • 用行为测试建立重构安全网
  • 通过小步提交降低定位和回滚成本

先锁定不允许改变的行为

重构改变内部结构,不应改变调用方可观察的输入、输出、副作用和错误语义。开始前应列出公开接口、返回格式、异常类型、日志或事件要求,以及性能上不能明显退化的关键路径。

若测试不足,先补行为测试再重构。不要在同一阶段同时修改业务规则和代码结构,否则测试失败时很难判断原因,也无法清晰评审。

把大重构拆成机械步骤

安全顺序通常是先重命名局部符号,再提取重复逻辑,然后调整依赖方向,最后删除旧实现。每一步都应保持可运行,并只解决一个结构问题。

可以让 Claude Code 每次只执行一个动作,例如“提取纯函数但保留原入口”“替换所有调用后运行测试”“确认无引用后删除旧方法”。这种约束比一次要求“优化整个模块”更容易审查。

持续运行行为测试

下面是片段示例,依赖当前目录是 Git 仓库,项目使用 pytest,实际测试路径可能不同。

bash
pytest tests/test_invoice_service.py -q
git diff --check
git diff -- src/invoice tests/test_invoice_service.py

预期输出

text
<发票服务相关测试全部通过>
<git diff --check 无输出>
<差异只包含本阶段重构文件与必要测试调整>

测试调整必须谨慎。若只是因为方法改名而重写大量断言,说明测试可能耦合了内部结构;应优先保留面向行为的测试,只调整真正属于公开契约的部分。

审查结构是否真的改善

重构完成后,不只检查测试,还要判断目标问题是否消失。例如重复逻辑是否只保留一份,依赖方向是否更清晰,命名是否表达业务含义,方法职责是否更单一。

同时检查是否产生新的抽象成本。为了消除三行重复而新增多层接口,可能让代码更难理解。Claude Code 可以提出重构建议,但最终应以项目规模、团队习惯和未来变化方向判断是否值得。

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

目录与阅读设置

阅读设置

17

记录一个想法

安全重构代码

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

登录哪都通