angular-migration

Angular Migration - AngularJS 到 Angular 框架迁移指南

技能概述

掌握 AngularJS 到 Angular 的迁移技术，支持混合模式运行、组件渐进式转换和依赖注入现代化升级。

适用场景

1. AngularJS 遗留应用现代化

适用于仍在使用 AngularJS 1.x 的老项目需要升级到现代 Angular 框架，通过 ngUpgrade 实现两套框架并行运行，降低迁移风险。

2. 大型企业应用渐进式升级

针对业务复杂、功能众多的企业级 Angular 应用，提供垂直切片和水平分层两种迁移策略，确保业务连续性的同时完成框架升级。

3. 组件和服务重构转换

将 AngularJS 的指令、控制器、服务逐个转换为 Angular 的组件和依赖注入模式，同步升级路由和表单系统到新版本架构。

核心功能

混合应用模式 (ngUpgrade)

通过 ngUpgrade 模块实现 AngularJS 和 Angular 在同一应用中并行运行，支持双向依赖注入共享、组件互通和路由协同，让迁移过程平滑可控。

组件和服务转换

提供 AngularJS Controller 到 Angular Component、Factory 到 Service 的转换模板和最佳实践，涵盖生命周期钩子、输入输出绑定和响应式数据模式。

路由和表单迁移

包含 AngularJS $routeProvider 到 Angular Router、ng-model 到 Reactive Forms 的完整迁移方案，支持模板驱动和响应式两种表单风格。

常见问题

AngularJS 迁移到 Angular 大约需要多长时间？

迁移周期取决于项目规模和选择的策略。小型应用（完全重写）约 1-2 个月，中型应用（渐进式）约 3-6 个月，大型企业应用可能需要 6-12 个月。建议分四个阶段：环境搭建（1-2 周）、基础设施迁移（2-4 周）、功能逐个迁移（按功能模块）、清理优化（1-2 周）。

应该选择完全重写还是 ngUpgrade 渐进式迁移？

对于小型新项目或技术债务严重的应用，完全重写成本更低；对于大型生产系统，ngUpgrade 渐进式迁移更安全，可以保持业务连续性并在迁移过程中持续交付功能。大多数企业应用建议选择渐进式迁移，通过垂直切片策略逐个功能模块完成升级。

混合模式下 AngularJS 和 Angular 组件可以互相调用吗？

可以，ngUpgrade 提供了 downgradeInjectable 和 upgradeComponent 等工具实现双向互通。Angular 服务可以降级后在 AngularJS 中使用，AngularJS 组件可以升级后在 Angular 中使用。但需要注意两套框架的变更检测机制不同，避免在同一组件中混合使用两种模式的绑定方式。