新旧Angular项目跨版本导入Feature Module的兼容性问题咨询

旧版本开发的特性模块导入新版本Angular项目 #

• 这类场景能不能正常跑，核心看两点：模块的封装形态、两个版本的差值大小：
  • 如果模块是跟旧项目强绑定的业务散模块（没按独立库的规范封装），升级时只要把常见的适配点改了就能正常跑：比如替换旧版本已经废弃的API写法、对齐RxJS版本、调整路由相关的配置。Angular从v9全面切到IVY引擎之后，对基于旧View Engine编译的模块给了很长时间的过渡兼容支持，跨1-2个大版本导入基本不会出现运行时直接崩的问题。
  • 如果模块是按规范打包发布的独立Angular库，只要版本差在2个大版本以内，且库声明的peerDependencies跟新项目的依赖没有硬冲突，基本可以正常加载；要是版本差超过2个大版本，会直接触发Angular运行时的依赖注入不兼容错误——Angular本身就不支持同一个运行时里跨大版本的注入器树串接，这种场景下没有通用的兼容解法。

新版本开发的特性模块导入旧版本Angular项目 #

• 这类场景有架构层面的硬性兼容问题，基本靠简单配置解决不了：
  • Angular在v9版本完成了从View Engine到IVY架构的整体切换，两个版本的编译产物、运行时结构完全不互通。v9及以上版本编译出来的产物是基于IVY运行时生成的，根本没法在还在用View Engine的旧版本（v8及更早）项目里正常加载。
  • 就算你改构建配置把新版本的模块降级编译成View Engine格式，也绕不开旧版本的能力缺口：新版本写的独立组件语法、信号能力、新增的注入API这些东西，在旧版本框架里根本没有对应的实现逻辑，硬导进去直接就报未定义的运行时错。

之前公开问答结论打架的原因 #

• 那些说“能实现多版本Angular模块共存”的方案，本质都是隔离实现：要么是靠微前端沙箱、路由切分把不同版本的Angular应用拆成独立的运行时环境，根本不是把不同版本的模块真的导到同一个应用的依赖树里；要么是那种只支持跨1-2个小版本的兼容配置，根本做不到跨大版本的通用兼容。
• 真正能落地的跨版本兼容方案，本质就是分版本打不同的构建包：每升一次Angular版本，就同步维护对应目标版本的构建分支，给不同版本的项目发匹配的产物包，不存在一个单一的新版本构建包能无差别适配所有旧版本项目的好事。

内容的提问来源于stack exchange，提问作者qkhanhpro