Claude Code 重构老项目失败：编译报错频出耗时一下午

背景

在移动开发领域，Objective-C (OC) 与 Swift 的混编项目是许多早期 iOS/macOS 应用面临的典型技术债务场景。随着业务逻辑的日益复杂，将遗留的 OC 代码逐步迁移至更现代、类型安全且性能更优的 Swift，成为提升代码可维护性和开发效率的关键路径。然而，这种迁移并非简单的语法转换，往往伴随着复杂的依赖关系、第三方 SDK 兼容性以及构建系统的调整。

近期，在 LINUX DO · AI 社区中，一位开发者分享了一次利用 AI 编码工具进行模块化重构的实战经历。该开发者尝试使用 Claude Code (CC) 结合 MiMo 2.5Pro 模型，对一个包含 OC/Swift 混编的老项目进行业务层全量 Swift 化重构。这一案例不仅反映了当前 AI 辅助编程在复杂遗留系统改造中的实际应用水平，也揭示了目前大语言模型在处理特定工程难题时的局限性。

核心内容

该开发者手头有一个历史悠久的 OC/Swift 混编项目。目前的架构状态是：业务层代码已经大部分迁移至 Swift，但仍有少量 OC 代码以及部分 OC 编写的第三方 SDK 遗留其中。项目的最终目标是实现业务层代码的全量 Swift 化，因此计划采取“按模块逐步推进”的策略进行重构。

作为第一步，开发者选择了一个相对较小的模块进行测试。该模块仅包含约 20 个类，代码总量估计在几千行以内。从规模上看，这属于典型的“小型重构任务”，开发者原本预期 AI 工具能够轻松完成这一工作。

在实际操作中，开发者调用了 Claude Code (CC) 配合 MiMo 2.5Pro 模型来执行重构任务。然而，结果并不理想。尽管投入了整个下午的时间，重构后的代码在编译阶段频繁报错，最终未能通过编译测试。这一结果与开发者最初的乐观预期形成了鲜明反差，甚至让开发者感到哭笑不得。

关键要点

• 技术栈现状：项目为 Objective-C 与 Swift 混编架构，业务层主体已 Swift 化，但残留少量 OC 代码及 OC 第三方 SDK。
• 重构策略：采取模块化渐进式迁移方案，旨在最终实现业务层全量 Swift 化。
• 测试模块规模：首个测试模块包含约 20 个类，代码量数千行，属于小规模重构单元。
• 使用的 AI 工具：Claude Code (CC) 作为代码执行/交互界面，底层模型为 MiMo 2.5Pro。
• 实际结果：耗时整个下午，编译仍频繁报错，重构失败，未能通过编译。
• 开发者反馈：预期与实际结果差距巨大，原本认为简单的任务变得极其困难，结果令人无奈。

意义与影响

这一案例生动地展示了当前 AI 编码助手在处理“遗留系统现代化”这一复杂工程问题时的真实能力边界。

首先，它打破了“AI 可以一键重构复杂遗留代码”的过度乐观预期。尽管 MiMo 2.5Pro 等先进模型在代码生成和理解上表现出色，但在处理涉及混合语言环境、第三方 SDK 依赖以及特定构建系统配置的上下文时，仍难以保证代码的即时可编译性和逻辑完整性。

其次，它强调了“人类在环”（Human-in-the-loop）在 AI 辅助开发中的必要性。即使是几千行代码的小模块，在涉及语言互操作性和构建配置时，也需要开发者进行细致的审查、调试和迭代。AI 工具目前更适合作为辅助建议者或样板代码生成器，而非完全自主的重构执行者。

最后，该案例为其他面临类似迁移任务的团队提供了参考：在进行大规模代码迁移前，应充分评估 AI 工具在特定技术栈下的表现，预留充足的调试和人工干预时间，避免对自动化效率产生不切实际的期待。