代码重构
代码能跑但越写越乱、想重构又怕改坏功能时,AI 能列出重复、过长、职责不清等问题,给出重构后的代码与改动对照表,并列出需要回归的场景。无测试须先补最小回归用例,AI 生成的断言要你确认后才据以回归。
你需要准备
- 语言与框架版本
- 团队代码规范与评审流程(GitHub PR / GitLab MR / 内部仓库)
- 待重构的代码
- 现有测试用例(强烈建议),以及调用方与依赖(缺失先标【待补】)
- (可选)静态检查结果(如圈复杂度、SonarQube)作为问题依据
怎么做
- 先声明语言与框架版本、团队规范与评审流程
- 若代码含密钥、token,先脱敏
- 贴代码、调用方与现有测试;没有测试就先让 AI 给可补的最小回归用例(提示词可直接复制)
- 对照表逐处核对改动(含是否影响行为),并逐条复核 AI 生成用例的断言是否反映正确行为,补齐【待补】项并跑回归测试后再提交
一句话提示词
下面这段代码能跑但我觉得写得乱,语言与框架版本、团队代码规范与评审流程(GitHub PR / GitLab MR / 内部仓库)我先声明,帮我在不改变功能、且符合我声明的团队规范的前提下重构:先指出主要问题(重复、过长、职责不清等),给出重构后的代码,再用一张对照表说明每处改动、好处,以及是否可能影响行为、需重点回归的场景,最后列出需要回归测试的场景;若项目没有测试,请先给出可补的最小回归用例,并提示我这些用例断言需人工确认是否反映正确行为、复核后再据以回归;我未提供的调用方或现有测试代码请标【待补】,不要编造。
它会交付什么
- 主要问题清单(重复、过长、职责不清等)——属 AI 归纳,需人工判断
- 重构后的代码 + 一张对照表(每处改动、好处、是否可能影响行为 / 需重点回归的场景)
- 需要回归测试的场景清单;无测试时须先补最小回归用例或明确标注该重构未被测试覆盖,且 AI 生成的用例断言须人工确认是否反映正确行为、复核后再据以回归(重构结果需人工判断、必须回归测试)
效果示例
输入一个约八十行、职责混杂的 Python 函数 + 已有 pytest 用例 → 输出重构后代码与对照表;缺少的调用方代码标【待补】。(示例为示意;重构结果需人工判断,必须回归测试)
常见问题
代码重构怎么保证不改变功能?没有单元测试怎么办?
先做等价重构,再逐处核对对照表;没有测试就先补最小回归用例,或明确标注这处重构未被测试覆盖。
AI 补的回归用例能直接当真吗?
不能。它依据现有代码生成,可能把错误行为固化成「期望」,断言须你人工确认是否反映正确行为后再据以回归。
重构的代码里有密钥、token 能直接发吗?
先脱敏再粘贴,密钥、token、连接串都不能出现在给 AI 的材料里。
对照表靠谱吗?
属 AI 归纳的问题与改动说明,需人工判断,别直接照搬。
一次能重构多大范围?
建议一个函数或一个类一批,范围太大风险高,请分批并逐步回归。