用 AI 重构遗留代码：从 800 行到 3 个模块

一句话结论

AI 重构遗留代码的成败，不取决于用 Cursor 还是 Claude Code，而取决于流程：先体检 → 让 AI 出重构计划 → 小步提交 → 每步可回滚。最大的坑是「让 AI 一口气大改 800 行」，结果 diff 没法 review、出错没法定位。把大任务拆成 5-10 个可验证的小步，成功率从约 50% 拉到 90%+。

重构前体检

动手前先用工具摸清代码债，别盲目相信 AI 的「我理解了」：

AI 之家 观点：没有测试覆盖的遗留代码，先让 AI 补测试再重构。补测试是重构的「安全网」——否则你永远不知道 AI 改没改坏逻辑。补测试的方法见 用 AI 写单元测试。

让 AI 先出「重构计划」再动手

不要直接说「重构这个文件」。先要计划：

分析 src/legacy/orderService.js（约 800 行），输出重构计划：
1. 识别职责（按业务拆成几个模块）
2. 标出高风险点（状态共享 / 副作用 / 隐式依赖）
3. 给出目标目录结构
4. 列出每步的验证方式（测试 / 手动）
不要改任何代码，只给计划。

AI 给计划后，你 review 风险点，确认无误再进入执行阶段。这一步能挡掉 80% 的「重构改坏逻辑」事故。

分步骤提示词模板

第 1 步：拆分巨型函数

把 processOrder() 按职责拆成 validateOrder / calcPrice / persistOrder 三个纯函数。
保持对外接口不变（仍导出 processOrder）。每拆一个函数补一个单元测试。

第 2 步：提取重复逻辑为 hook / util

扫描 src/ 里重复的日期格式化 / 错误处理代码，提取到 src/utils/。
替换所有调用点，确保行为一致。

第 3 步：加测试

按 用 AI 写单元测试 的三段式提示词补测试。

第 4 步：验证

跑 pnpm test + pnpm build，确认全绿。对比改动前后行为无差异。

每步回滚策略

铁律：每完成一个子目标就 commit。 任何一步翻车，git reset --hard <上一个干净 commit> 即可。

git add -A && git commit -m "refactor: split processOrder into 3 fns"
# 下一步前再 commit，绝不攒一大坨

Claude Code 用户可用 /rewind 回滚到任意 checkpoint（代码 + 对话）。Cursor 用户每步 Accept 前看 diff 预览，别无脑 Accept All。

AI 之家 观点：git 是重构的「无限后悔药」。我们规定「任何单步 diff 不超过 200 行、必须能单独 revert」，AI 改得再顺也不能破这个规矩。

真实案例：90 分钟拆 800 行

一个 Express 的 orderService.js（800 行、0 测试、3 个循环依赖）：

关键：中间第 2 步 AI 把一个副作用写错（改了全局状态），因为每步都 commit，直接 git reset 回到上一步，改提示词重跑，没影响其他进度。

常见失败模式与对策

什么时候不该用 AI 重构

这套流程不是万能的。以下四类场景下，让 AI 主导重构的期望收益低于风险，建议改为人主导、AI 辅助：

判断标准其实只有一条：你能不能在改完之后，用一句可执行的话判定「没坏」。能，就可以交给 AI 推进；不能，就先补判定手段。

让 AI 重构的六个纪律

前面各节讲的是步骤，这里收敛成可以贴在团队 wiki 上的六条：

1. 先要计划，再要代码。 AI 直接吐 diff 时你失去了拒绝的机会——计划阶段拒绝的成本是零，代码阶段拒绝的成本是已经花掉的时间。
2. 一步一个 commit，且每个 commit 都能独立编译 / 通过测试。 「可回滚」的粒度就是 commit 的粒度。
3. 测试先于实现。 让 AI 改了测试让它通过的「假绿」，是重构里最贵的失败——它把质量 gate 本身污染了。
4. 明确写出「不许做什么」。 不引入新依赖、不改对外接口、不动公共工具函数。负面清单比正面描述更有效，因为模型的默认倾向是「顺手改进」。
5. 每步之后人读一遍 diff。 不用逐行，但要看改动范围是否符合预期——本来说改 3 个文件结果动了 11 个，这就是信号。
6. 保留一次完整回滚点。 开始重构前打一个 tag 或分支。这条听起来多余，直到你真的需要它。

更新说明

• 2026-09-28：新增「什么时候不该用 AI 重构」与「让 AI 重构的六个纪律」两节；正文步骤、提示词模板与案例未作改动。
• 本文的提示词模板基于 Cursor 与 Claude Code 的通用能力编写，未针对特定版本做一手实测；两个工具的版本节奏较快，斜杠命令与配置项请以各自官方文档为准。

相关阅读

• 工具卡：Cursor ｜ Claude Code
• 方案：大型重构实战 ｜ 用 AI 写单元测试
• 对比：Cursor vs Claude Code
• 概念：Vibe Coding

来源说明：本文基于 Cursor / Claude Code 官方文档及 AI 之家 编辑部重构实践归纳。命令与功能以最新官方文档为准。