npm i执行失败：无法解析依赖树（Angular 15环境）

冲突来源 #

从报错日志可以明确定位：

• 项目当前依赖@angular/core@15.2.9，但npm解析依赖时自动选择了@angular/common@16.0.4，而这个版本要求的peer依赖是@angular/core@16.0.4，和现有core版本完全不兼容，直接触发依赖树解析失败。
• 冲突的触发链路是：mylib@2.7.0 → @angular/cdk@15.2.9 → @angular/common。其中@angular/cdk@15.2.9的peer依赖允许@angular/common使用^15.0.0 || ^16.0.0范围的版本，npm的依赖解析逻辑现在优先选中了16.x版本，导致和项目锁定的Angular 15版本冲突。
• 之前执行npm i无异常，大概率是因为npm缓存的依赖版本未更新，或是近期npm的依赖解析规则调整，才触发了这个隐藏的依赖范围问题。

解决方案 #

1. 明确锁定@angular/common版本 #

在项目的package.json中，将@angular/common的版本指定为和@angular/core一致的15.2.9，示例配置：

"dependencies": {
  "@angular/common": "15.2.9",
  "@angular/core": "15.2.9",
  // 其他依赖项...
}

之后删除node_modules和package-lock.json，重新执行npm install。

2. 使用npm兼容参数临时绕过冲突 #

如果暂时不想修改依赖配置，可以执行：

npm install --legacy-peer-deps

该参数会让npm采用旧版peer依赖解析逻辑，忽略版本冲突。如果仍未解决，可尝试：

npm install --force

注意：--force会强制安装不兼容的依赖，可能引发运行时异常，需谨慎使用。

3. 检查并更新mylib #

确认mylib是否有更新版本，新版本可能已修复依赖范围问题，适配更稳定的Angular 15依赖组合。若无合适版本，可向mylib维护者提交issue说明该冲突问题。

4. 清理npm缓存排除干扰 #

执行以下命令清理缓存，避免旧缓存影响依赖解析：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

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