Angular 11 执行npm install时报无法解析依赖树错误求助

问题排查与解决方案 #

根因说明 #

项目依赖的@coreui/icons-angular@1.0.0-alpha.3为预发布版本，其peer依赖要求Angular版本 >=12.0.0，而项目所有Angular相关依赖均为11.x版本，版本不兼容是依赖树解析失败的核心原因。即便添加--legacy-peer-deps参数仍安装失败，通常由以下附加因素导致：

• npm版本过高：npm 7+的依赖解析规则更严格，部分场景下--legacy-peer-deps参数无法覆盖预发布版本的依赖校验
• 本地残留旧依赖文件、npm缓存存在损坏内容
• Node.js版本超出项目适配范围，项目配置的engines要求Node.js版本>=10.13，过高的Node.js版本（如16+）也会加剧依赖兼容性问题

解决步骤 #

• 调整coreui相关依赖版本适配Angular 11
  修改package.json中coreui图标的两项依赖配置：

  "@coreui/icons": "^1.0.0",
  "@coreui/icons-angular": "1.0.0-alpha.2"
  

  该版本组合的peer依赖完全兼容Angular 11版本。
• 清理残留依赖与缓存
  依次执行以下操作：
  1. 删除项目根目录下的node_modules文件夹、package-lock.json文件
  2. 执行npm cache clean --force清理全局npm缓存
• 重新执行安装命令
  运行安装命令：npm install --legacy-peer-deps --force
• 可选调整（如果上述操作仍失败）
  切换Node.js与npm版本至适配组合：Node.js 14.x + npm 6.x，该版本组合完全匹配项目的engines要求与Angular 11的运行环境。

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