Angular 12升级至16时@ng-bootstrap依赖兼容问题求助

核心问题说明 #

你遇到的peer依赖不兼容，是因为当前@ng-bootstrap/ng-bootstrap版本仅支持Angular11，与要升级的Angular13版本不匹配；之后直接升级到^14.1.0出错，是因为该版本适配的是Angular14，跨版本跳跃升级导致了更多依赖冲突和潜在的API不兼容。

推荐的分步升级方案 #

1. 回退@ng-bootstrap/ng-bootstrap到适配Angular13的版本

先卸载错误安装的14.1.0版本：

npm uninstall @ng-bootstrap/ng-bootstrap

安装与Angular13兼容的ng-bootstrap 12.x稳定版（推荐12.1.2）：

npm install @ng-bootstrap/ng-bootstrap@12.1.2

2. 完成Angular12到13的升级

执行官方升级命令，此时peer依赖已匹配，可顺利完成升级：

ng update @angular/core@13 @angular/cli@13

3. 按版本对应关系逐步升级到Angular16

ng-bootstrap与Angular的版本对应规则为：

• Angular 13 → ng-bootstrap 12.x
• Angular 14 → ng-bootstrap 13.x
• Angular 15 → ng-bootstrap 14.x
• Angular 16 → ng-bootstrap 15.x

按照以下顺序依次升级：

• 升级到Angular14：
  先安装适配的ng-bootstrap版本：

  npm install @ng-bootstrap/ng-bootstrap@13.1.1
  

  再执行Angular升级命令：

  ng update @angular/core@14 @angular/cli@14
  

• 升级到Angular15：
  安装适配的ng-bootstrap版本：

  npm install @ng-bootstrap/ng-bootstrap@14.2.0
  

  再执行Angular升级命令：

  ng update @angular/core@15 @angular/cli@15
  

• 升级到Angular16：
  安装适配的ng-bootstrap版本：

  npm install @ng-bootstrap/ng-bootstrap@15.1.1
  

  再执行Angular升级命令：

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

4. 调整代码适配API变更

ng-bootstrap的大版本升级会伴随部分API的废弃或变更，完成依赖升级后，需要对照对应版本的更新说明，修改代码中使用的过时组件、输入输出属性等，确保功能正常运行。

内容的提问来源于stack exchange，提问作者g. Skud