Angular 8迁移后npm install遇依赖冲突错误求助

问题原因 #

1. ERESOLVE依赖树错误根源 #

项目依赖的@angular/compiler版本为8.2.12，但开发依赖里的@angular/compiler-cli@8.2.14的peer依赖明确要求@angular/compiler必须是8.2.14版本。npm 7及以上版本对peer依赖的校验逻辑更严格，一旦发现版本不匹配就会抛出ERESOLVE错误，阻止安装。

2. 使用--legacy-peer-deps后意外安装Angular14的原因 #

--legacy-peer-deps会让npm跳过peer依赖的版本校验，但如果你的package.json中部分Angular核心包的版本范围设置得过于宽松（比如未明确锁定主版本），再加上npm 7+的依赖解析逻辑和旧版本Angular不兼容，就会导致npm错误拉取到满足宽泛版本范围的最高版本包（也就是Angular14）。另外，高版本npm和Angular8的依赖管理逻辑存在兼容性差异，也是引发这个问题的关键因素。

解决方法 #

1. 统一Angular核心依赖版本 #

直接修改package.json，将所有@angular/开头的依赖（包括核心包、compiler、compiler-cli等）统一指定为8.2.14版本，确保peer依赖完全匹配：

"dependencies": {
  "@angular/compiler": "8.2.14",
  "@angular/core": "8.2.14",
  "@angular/common": "8.2.14",
  // 其余@angular相关依赖全部同步为8.2.14
},
"devDependencies": {
  "@angular/compiler-cli": "8.2.14",
  "@angular-devkit/build-angular": "0.803.29",
  // 其余Angular开发依赖也统一版本
}

2. 降级npm到兼容版本 #

Angular 8官方推荐使用npm 6.x版本，这个版本的peer依赖处理逻辑和Angular8完全兼容，不会出现解析偏差。执行以下命令降级npm：

npm install -g npm@6

3. 清理缓存后重新安装 #

先删除本地的依赖目录和锁定文件，避免残留的旧依赖影响安装：

# Windows系统执行：rmdir /s /q node_modules && del package-lock.json
rm -rf node_modules package-lock.json

然后执行正常安装命令：

npm install

4. 若需保留高版本npm的替代方案 #

如果不想降级npm，可以使用--force参数强制安装，但这个操作会忽略所有版本冲突，可能引入潜在的兼容性问题，仅作为临时方案使用：

npm install --force

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