Angular添加新依赖时出现ERESOLVE冲突错误，如何修复？

尝试添加新npm包时触发ERESOLVE依赖解析错误，已更新Angular及相关依赖但问题未解决，错误日志如下：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! 解析时：@ng-bootstrap/ng-bootstrap@12.1.1
npm ERR! 发现：@angular/common@14.2.8
npm ERR! node_modules/@angular/common
npm ERR!   来自@angular/cdk@13.3.7的peer依赖要求@angular/common@"^13.0.0 || ^14.0.0-0"
npm ERR!   node_modules/@angular/cdk
npm ERR!     来自@angular/material@13.3.7的peer依赖要求@angular/cdk@"13.3.7"
npm ERR!     node_modules/@angular/material
npm ERR!       @angular/material@"^13.3.7"来自根项目
npm ERR! 修复上游依赖冲突，或使用--force、--legacy-peer-deps参数重试命令
npm ERR! 以接受不正确（可能损坏）的依赖解析结果。
npm ERR!
npm ERR! 完整报告请查看：C:\Users\nizal\AppData\Local\npm-cache\eresolve-report.txt

npm ERR! 本次运行的完整日志可在以下路径找到：
npm ERR!     C:\Users\nizal\AppData\Local\npm-cache\_logs\2022-12-21T09_02_27_026Z-debug-0.log

解决方法 #

1. 匹配依赖版本（推荐方案） #

核心问题是版本不兼容：@ng-bootstrap/ng-bootstrap@12.1.1要求Angular 14.x，但你的@angular/material和@angular/cdk仍为13.3.7，cdk 13.x对@angular/common的版本要求与ng-bootstrap规则冲突。

操作步骤：

• 升级@angular/material和@angular/cdk到与当前Angular 14.2.8匹配的14.x版本：

  npm install @angular/material@14 @angular/cdk@14 --save
  

• 重新安装目标npm包，此时依赖解析可正常完成。

2. 临时绕过依赖检查（应急方案） #

若暂时无法升级依赖，可使用npm参数强制跳过冲突检查：

• 使用--legacy-peer-deps：回到npm v6依赖解析逻辑，忽略peer依赖冲突（相对安全）

  npm install [你的目标包名] --legacy-peer-deps
  

• 使用--force：强制安装，可能导致依赖树损坏，仅紧急情况使用

  npm install [你的目标包名] --force
  

3. 清理缓存后重试 #

缓存异常可能引发解析失败，先清理缓存再重新安装：

npm cache clean --force
# Windows系统执行
rmdir /s /q node_modules && del package-lock.json
# macOS/Linux系统执行
rm -rf node_modules package-lock.json
npm install

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