解决npm依赖冲突：更新Angular CLI时遇ERESOLVE错误

我尝试本地更新Angular CLI，执行npm uninstall --save-dev angular-cli后出现ERESOLVE错误，执行npm install也触发相同错误。核心原因是@angular-devkit/build-angular@15.0.4要求对等依赖@angular/compiler-cli@^15.0.0，但当前项目依赖的是@angular/compiler-cli@12.2.2，版本不匹配导致冲突。

错误日志如下：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR! 
npm ERR! While resolving: @angular-devkit/build-angular@15.0.4
npm ERR! Found: @angular/compiler-cli@12.2.2
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   dev @angular/compiler-cli@"~12.2.1" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/compiler-cli@"^15.0.0" from @angular-devkit/build-angular@15.0.4
npm ERR! node_modules/@angular-devkit/build-angular
npm ERR!   dev @angular-devkit/build-angular@"^15.0.4" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: @angular/compiler-cli@15.0.4
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   peer @angular/compiler-cli@"^15.0.0" from @angular-devkit/build-angular@15.0.4
npm ERR!   node_modules/@angular-devkit/build-angular
npm ERR!     dev @angular-devkit/build-angular@"^15.0.4" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 

可行解决方法 #

方法1：按Angular官方路径逐步升级 #

Angular不建议跨大版本直接升级（如12→15），容易引发依赖混乱，正确步骤是分版本递进升级：

• 先升级到Angular 13：

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

• 再升级到Angular 14：

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

• 最后升级到Angular 15：

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

每次升级后执行npm install确认依赖安装完成，同步处理代码兼容性问题。

方法2：临时绕过依赖检查（不推荐生产环境） #

若仅需临时完成依赖安装，可使用npm参数跳过对等依赖校验：

• 使用--legacy-peer-deps（npm v7+推荐，兼容旧版依赖解析逻辑）：

  npm install --legacy-peer-deps
  

• 或用--force强制安装（可能导致依赖树异常，风险较高）：

  npm install --force
  

方法3：手动调整package.json依赖版本 #

1. 打开项目根目录的package.json文件
2. 将@angular/compiler-cli版本从~12.2.1修改为^15.0.0
3. 同步将所有@angular/*相关包的版本调整为15.x稳定版，确保与@angular-devkit/build-angular@15.0.4匹配
4. 删除node_modules文件夹和package-lock.json文件
5. 重新执行npm install

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