Angular 10升级至16：无中间版本内部库的升级方案咨询

前置准备 #

• 备份当前项目代码（可通过Git创建分支或本地复制文件）
• 确认本地已安装Node.js 16+（Angular 16要求Node.js最低版本为16.14.0）

具体步骤 #

1. 移除旧版内部库依赖 #

先卸载项目中基于Angular 10的内部开发库，避免新旧版本冲突：

npm uninstall @your-internal-library/package1 @your-internal-library/package2

或者直接在package.json中删除所有内部库相关的依赖项，再执行npm install清理残留。

2. 跨版本升级Angular核心与CLI #

跳过中间版本直接升级到Angular 16：

• 全局更新Angular CLI：

npm uninstall -g @angular/cli
npm install -g @angular/cli@16

• 升级项目内的Angular依赖（添加--force跳过跨版本检查）：

ng update @angular/core@16 @angular/cli@16 --force

• 同步升级配套依赖（rxjs、zone.js等需适配Angular 16版本）：

npm update rxjs zone.js

3. 安装新版内部库 #

安装已升级至Angular 16的内部开发库：

npm install @your-internal-library/package1@16 @your-internal-library/package2@16

4. 修复兼容性问题 #

• Angular API变更修复：对照编译器报错，处理10到16版本间的废弃/移除API，比如ViewChild的static选项移除、路由守卫API调整、HttpClient拦截器写法变化等。
• 内部库适配：根据内部库的升级说明（若有），调整组件调用、服务注入、输入输出参数等，适配新版库的API变更。
• 执行ng build和ng test，逐一解决编译、测试报错。

5. 验证项目功能 #

• 启动开发服务器：ng serve，检查页面渲染、交互是否正常
• 测试核心业务流程，确保无功能异常

补充说明 #

虽然Angular官方推荐逐次升级主版本，但在内部库仅提供首尾版本的场景下，直接跨版本升级是可行的核心方案。重点是做好依赖的彻底替换，以及耐心处理代码层面的兼容性调整。

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