Angular项目执行npm install时依赖树解析失败问题求助

报错信息 #

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR!
npm ERR! While resolving: cloud-share@0.0.0
npm ERR! Found: @angular/compiler-cli@15.2.9
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   dev @angular/compiler-cli@"^15.2.9" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/compiler-cli@"^16.0.0" from @angular-devkit/build-angular@16.1.3
npm ERR! node_modules/@angular-devkit/build-angular
npm ERR!   dev @angular-devkit/build-angular@"^16.1.3" from the root project

问题原因 #

项目中@angular/compiler-cli@15.2.9与@angular-devkit/build-angular@16.1.3存在peer依赖冲突：后者要求@angular/compiler-cli版本必须为^16.0.0，但当前项目使用的是15.x版本。

解决方案 #

方案1：升级Angular核心包到16.x版本

将所有Angular核心依赖统一升级到16.x，确保与构建工具版本兼容：

• 卸载冲突依赖：

  npm uninstall @angular/compiler-cli @angular-devkit/build-angular
  

• 安装匹配版本：

  npm install --save-dev @angular/compiler-cli@^16.0.0 @angular-devkit/build-angular@^16.1.3
  

• 升级其他Angular核心包（如@angular/core、@angular/common等），推荐用Angular CLI命令批量升级：

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

• 最后执行完整安装：

  npm install
  

方案2：降级@angular-devkit/build-angular到适配15.x的版本

若暂时不想升级Angular核心版本，可将构建工具降级到支持Angular 15的版本：

• 卸载现有构建工具：

  npm uninstall @angular-devkit/build-angular
  

• 安装适配版本：

  npm install --save-dev @angular-devkit/build-angular@^15.2.0
  

• 执行安装：

  npm install
  

方案3：临时跳过peer依赖检查（不推荐）

使用--legacy-peer-deps参数强制跳过依赖冲突检查，仅作为临时应急方案，可能引发潜在兼容性问题：

npm install --legacy-peer-deps

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