安装Angular Material包遭遇ERESOLVE依赖冲突错误求助

执行的安装命令 #

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

报错信息（中文翻译） #

npm ERR! code ERESOLVE
npm ERR! ERESOLVE 无法解析依赖
npm ERR!
npm ERR! 解析时出错: scheduler@0.0.0
npm ERR! 已找到: @angular/animations@15.0.1
npm ERR! node_modules/@angular/animations
npm ERR!   来自@angular/platform-browser@15.0.1的可选对等依赖@angular/animations@"15.0.1"
npm ERR!   node_modules/@angular/platform-browser
npm ERR!     来自@angular/forms@15.0.1的对等依赖@angular/platform-browser@"15.0.1"
npm ERR!     node_modules/@angular/forms
npm ERR!       根项目依赖@angular/forms@"^15.0.1"
npm ERR!     来自@angular/platform-browser-dynamic@15.0.1的对等依赖@angular/platform-browser@"15.0.1"
npm ERR!     node_modules/@angular/platform-browser-dynamic
npm ERR!       根项目依赖@angular/platform-browser-dynamic@"^15.0.1"
npm ERR!     另外2个依赖(@angular/router, 根项目)
npm ERR!   根项目依赖@angular/animations@"*"
npm ERR!
npm ERR! 无法解析依赖:
npm ERR! 根项目依赖@angular/animations@"*"
npm ERR!
npm ERR! 冲突的对等依赖: @angular/core@15.0.3
npm ERR! node_modules/@angular/core
npm ERR!   来自@angular/animations@15.0.3的对等依赖@angular/core@"15.0.3"
npm ERR!   node_modules/@angular/animations
npm ERR!     根项目依赖@angular/animations@"*"
npm ERR!
npm ERR! 修复上游依赖冲突，或使用 --force 或 --legacy-peer-deps 参数重试命令
npm ERR! 以接受可能不正确（且可能损坏）的依赖解析结果。
npm ERR!
npm ERR! 完整报告请查看: C:\Users\rejki\AppData\Local\npm-cache\eresolve-report.txt

npm ERR! 本次运行的完整日志可在以下位置找到:
npm ERR!     C:\Users\rejki\AppData\Local\npm-cache\_logs\2022-12-14T10_44_35_365Z-debug.log

问题原因 #

这是典型的npm对等依赖版本冲突：

• 你的项目当前使用的Angular核心包（@angular/core）及配套包（如@angular/platform-browser）都是15.0.1版本
• 你在package.json中把@angular/animations的版本设为了*（表示安装最新版本），npm会尝试拉取最新的15.0.3版本，但该版本要求@angular/core必须是15.0.3，和现有项目的15.0.1版本不兼容，导致依赖解析失败

解决方法 #

方法1：统一Angular包版本（推荐）

将所有Angular核心包升级到相同小版本，彻底解决依赖不匹配问题：

1. 先升级所有Angular核心依赖到15.0.3：

npm install @angular/core@15.0.3 @angular/common@15.0.3 @angular/platform-browser@15.0.3 @angular/platform-browser-dynamic@15.0.3 @angular/forms@15.0.3 @angular/router@15.0.3 --save

2. 再执行Angular Material的安装命令：

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

方法2：指定匹配版本的animations

直接安装和当前项目配套的15.0.1版本，避免版本跳跃：

npm install @angular/material @angular/cdk @angular/animations@15.0.1 --save

方法3：使用npm兼容模式（临时方案）

如果暂时不想调整版本，可通过参数跳过依赖检查，但可能存在潜在兼容性风险：

npm install @angular/material @angular/cdk @angular/animations --save --legacy-peer-deps

--legacy-peer-deps会采用npm v6的依赖解析逻辑，忽略对等依赖冲突，比--force更稳妥。

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