Node V18环境下安装依赖时出现Peer依赖冲突错误求助

问题根源 #

你的项目依赖@agm/core@1.1.0，该包仅支持Angular 6-8版本，但当前项目使用的是Angular 13.2.4，版本完全不兼容；同时Node.js 18默认配套的npm 8+对peer依赖的校验规则更严格，因此安装依赖时触发了冲突报错。

解决方案 #

1. 临时绕过冲突（快速应急） #

若需紧急完成依赖安装，可使用npm提供的参数跳过严格的peer依赖检查：

• 执行安装命令时添加--legacy-peer-deps：

  npm install --legacy-peer-deps
  

  该参数会让npm切换到npm 4-6的peer依赖处理逻辑，忽略版本不匹配的冲突，但仅作为临时方案，可能埋下运行时错误隐患。
• 或使用--force强制安装：

  npm install --force
  

  此参数会强制覆盖冲突依赖，但风险更高，不推荐长期使用。

2. 彻底解决版本冲突（推荐） #

方案A：升级@agm/core到兼容Angular 13的版本

@agm/core后续版本已支持更高版本Angular，可安装适配Angular 13的版本，例如：

npm install @agm/core@^3.0.0-beta.0

（该版本支持Angular 12+，可完美适配你的Angular 13项目）

方案B：替换@agm/core

若@agm/core无法升级或维护停滞，可改用官方提供的Google Maps集成包@angular/google-maps，它支持最新Angular版本：

npm install @angular/google-maps

方案C：降级Angular版本（不推荐）

如果必须保留@agm/core@1.1.0，可考虑将Angular降级到8.x版本，但这会导致jest-preset-angular@11.1.1（要求Angular >=10）出现新的冲突，仅在极端场景下考虑。

额外校验 #

确认jest-preset-angular@11.1.1与Angular 13的兼容性：该版本支持Angular 10+，理论上兼容Angular 13，若后续出现运行问题，可升级jest-preset-angular到适配Angular 13的版本（如^12.2.0）。

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