第14章 重构与代码库迁移
第11章把重构和迁移列为两类重要的编码工作流。二者都涉及对既有代码的系统性修改，但目标并不相同。重构是在保持外部可观察行为基本不变的前提下改善代码内部结构；代码库迁移则是把既有实现从一种依赖、接口、框架、语言或运行环境转换到另一种状态，并在转换过程中维持必要的业务行为和兼容关系。迁移的风险通常来自改动范围广、隐含依赖多，以及新旧实现可能长期并存。如果缺少明确的起止状态、兼容边界和验证机制，局部改动即使能够运行，也可能使代码库停留在难以维护的中间状态。
重构和迁移也是智能体较能发挥规模化执行优势的场景。许多工作可以表达为明确、重复的转换规则，并能够按照文件或模块拆分，结合搜索、测试和静态检查逐批推进。智能体可以加快代码分析和机械性修改，却不能替代迁移策略、架构取舍和风险接受等判断。本章以迁移为主线，说明为什么迁移是智能体能够发挥规模化执行优势的场景，随后讨论如何通过只读探查建立现状基线和风险登记册，如何根据代码库的耦合程度与交付约束选择迁移模式，以及如何利用批次门控和分层验证控制大规模改动。这套方法同样适用于重构，最后一节以IoTFlow网关中的三个协议适配器为例，演示如何用同一套方法完成一次保持外部行为不变的接口重构。
读完本章，读者应能区分重构与代码库迁移的目标和边界，能够在修改前识别必须保留的行为与隐含约束，选择适合的迁移节奏，把大规模改动拆分为可验证、可归因和可回退的批次，并通过行为、结构、安全和性能等多层证据判断改动是否真正可信。