先固定回归测试基线，再让 Copilot 比较三段重复代码的共同点与差异，分批提取公共函数，并用完整测试和人工审查控制重构风险。
这次只做一件事：把三个重复代码块提取为一个公共函数，同时保持调用结果、异常和副作用不变。GitHub Copilot 用于比较片段、提出签名和生成小补丁；是否属于安全重构，则由现有测试、Git 差异和人工审查共同决定。
版本、权限与基线要求
本文以 Visual Studio Code 当前稳定版和 GitHub Copilot 当前稳定扩展为背景，日期为 2026 年 8 月 30 日。Edit、Chat、Agent 等入口名称、模型选择和组织权限可能变化，请核对 GitHub Copilot 使用文档及当前账户界面，不要依赖固定菜单路径。
| 开始前 | 最低要求 |
|---|---|
| 版本控制 | 工作区无未解释修改，并已创建独立分支 |
| 回归保护 | 存在可执行测试，已记录基线命令和结果 |
| 改动范围 | 三个重复块规模可控，不同时调整公共接口 |
VS Code 的 AI 功能和上下文入口应以 VS Code 官方 AI 文档为准。若组织禁用了某种编辑模式，就让 Copilot 只解释和生成候选差异，再由开发者手动修改。
识别真正相同的部分
看起来相似的代码未必拥有相同语义。先把三段代码并排比较，标出共同步骤、变量来源、返回值、日志、异常、事务边界和执行顺序。尤其要检查某一段是否多做了权限判断、单位转换或空值处理；这些差异不能被公共函数悄悄吞掉。
任务：比较片段 A、B、C，找出可安全提取的最小共同逻辑。
约束：保持返回值、异常、副作用和调用顺序不变。
先输出：共同点、差异点、不可合并项、建议函数签名。
暂时不要编辑代码，也不要引入新依赖。重构的核心是通过一系列小改动改善内部结构，而不改变可观察行为。可参考 Martin Fowler 的 Refactoring 资料页理解这一边界。若当前测试没有覆盖三处差异，应先补特征测试，而不是直接提取。
用四个小补丁完成提取
- 记录基线。运行相关测试与完整测试集，保存命令、提交号和已知失败；基线不稳定时先停止重构。
- 创建最小公共函数。仅搬运真正相同的表达式，参数名反映业务含义，不提前设计通用框架。
- 替换第一个调用点。运行相关测试，比较输出、异常、日志及状态变化，通过后单独提交。
- 依次替换第二、第三处。每次只替换一个调用点并重新测试，不让 Copilot 一次改遍整个仓库。
- 清理重复代码。三个调用点均稳定后，再删除失效导入和局部变量，最后运行全量检查。
给 Copilot 的编辑指令要限定文件和边界。例如：“只修改 helper 文件与调用点 A；不要改测试、格式化无关文件或调整错误文案；输出修改理由和风险。”如果建议增加布尔参数来兼容大量差异，应重新判断这些代码是否真的适合合并。
如何证明行为没有改变
| 检查维度 | 验证方法 |
|---|---|
| 返回值 | 运行原有断言，必要时为三个调用路径各补一个特征测试 |
| 异常 | 确认类型、触发条件及捕获层级没有变化 |
| 副作用 | 核对写入、日志、事件、缓存和外部请求次数 |
| 执行顺序 | 检查事务、异步等待和资源释放位置 |
| 代码差异 | 逐文件查看 Git diff，排除自动格式化噪声 |
测试全部通过只说明已覆盖行为没有发现差异，并不证明所有行为完全相同。高风险路径还应由熟悉业务的人检查函数签名、默认值和调用顺序。公共函数的位置也要符合项目现有结构，不要仅因 Copilot 建议就创建新的工具类。
失败诊断与回退
- 第一个调用点就失败：检查参数映射、默认值、闭包变量和提前返回。
- 只有某一处失败：说明该片段存在语义差异，先恢复该提交，再决定保留分支逻辑还是不合并。
- 全量测试失败：排查公共状态、导入副作用、测试隔离和调用顺序。
- 差异过大难审查：撤销补丁，关闭无关格式化，把创建函数与替换调用点拆开。
- Copilot 反复扩大范围：缩小上下文，明确允许修改的文件，并要求先给计划而非直接编辑。
最可靠的回退单位是小提交。每替换一个调用点便提交一次，失败时可精确恢复，而不是在一大块混合修改中寻找原因。
隐私、版权与成本边界
发送上下文前应删除密钥、客户信息、内部地址和受限制代码，并核对组织对 Copilot、遥测、内容保留及建议使用的政策。生成的代码仍需检查许可证要求、依赖来源和安全性，不能因为来自助手就默认可以发布。订阅、模型和请求额度可能因个人或组织方案不同而变化，具体成本以当前账户为准。
结论
GitHub Copilot 重复代码重构最适合做“受约束的候选编辑器”：先识别最小共同逻辑，再一次替换一个调用点。基线测试、小提交、完整回归和人工语义检查缺一不可；只要无法解释某段差异，就宁可暂时保留重复，也不要制造错误抽象。
常见问题
测试通过是否代表重构一定安全？
不一定。测试只能验证已覆盖行为，还要人工检查异常、副作用、调用顺序、默认值和未被测试捕获的业务差异。
三个代码块只有八成相同，还应该提取吗？
视差异语义而定。可以只提取稳定的最小共同部分；若需要大量布尔参数或条件分支，保留局部重复可能更清楚。
可以让 Copilot 一次完成所有重构吗？
技术上可能可用，但不利于定位回归。更稳妥的方式是创建函数、逐个替换调用点、清理代码分别执行和验证。