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 可以提出重构建议,但最终应以项目规模、团队习惯和未来变化方向判断是否值得。
按自己的节奏,确认真正理解。