SuperAPI AI 工具集

principle-migrate-callers-then-delete-legacy-apis

编程与开发

查看项目

更新于 10-16 02:30

技能介绍

用途:适用于引入新的内部 API、而旧调用方仍然存在的场景。该原则主张在确定新 API 是正确设计后,在同一次重构批次中迁移调用方并删除旧 API,而不是保留兼容层。

规则要点:不要仅因为内部调用方仍存在就保留旧 API 路径;清点调用方、完成迁移后立即删除旧 API;临时适配层应视为例外并设定时间盒,而非默认架构;更新测试以断言新契约,并删除那些只保护重构前实现细节的测试。

适用条件:没有外部用户依赖向后兼容;项目能够承受协调一致的破坏性变更;新 API 属于简化或重构工作的一部分。

限制与理由:保留新旧两套 API 会带来双路径复杂度,拖慢清理,并让代码库呈现只增不减的状态。资料未提供具体命令、示例代码或更多实施步骤。