npm install报ERESOLVE could not resolve依赖冲突排查

这是典型的Angular生态依赖大版本不匹配问题，无其他隐式冲突：

• 你项目中所有核心Angular包（@angular/core/@angular/common/@angular/cli/@angular/compiler-cli等）均为14.0.x版本
• 但devDependencies里的构建工具@angular-devkit/build-angular停留在12.2.17版本，该版本的peer依赖强制要求@angular/compiler-cli版本范围为^12.0.0，和你当前声明的14.0.x版本完全不兼容，直接触发依赖解析失败。
• 额外注意：你当前安装的@angular-eslint/*系列包全为12.x版本，和Angular 14同样存在版本匹配问题，就算临时绕过build-angular的冲突，后续也会触发新的依赖报错。

不要使用--force或--legacy-peer-deps参数绕过校验，直接对齐所有Angular生态包的大版本即可彻底解决：

1. 将@angular-devkit/build-angular升级到与Angular 14匹配的版本：

   npm install --save-dev @angular-devkit/build-angular@~14.0.2
   

2. 同步升级所有@angular-eslint/*包到14.x对应版本，避免后续冲突：

   npm install --save-dev @angular-eslint/builder@~14.0.0 @angular-eslint/eslint-plugin@~14.0.0 @angular-eslint/eslint-plugin-template@~14.0.0 @angular-eslint/template-parser@~14.0.0
   

3. 删除项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install即可完成无错安装。

Angular官方生态包（包含@angular/*、@angular-devkit/*、@angular-eslint/*、@angular/cli）必须保持完全一致的大版本号，这是Angular版本管理的硬性规则，违反则必然出现peer依赖冲突。

npm 7及以上版本抛出的ERESOLVE peer依赖冲突有固定的信息结构，按顺序读取即可快速定位冲突源，不需要盲目猜版本：

• 第一步：定位While resolving: <包名@版本号>行：这是提出依赖要求的主体包，本次报错中该主体为@angular-devkit/build-angular@12.2.17
• 第二步：定位Found: <包名@版本号>行：这是你项目中当前已声明/已安装的冲突包实际版本，本次报错中实际安装的是@angular/compiler-cli@14.0.3
• 第三步：定位Could not resolve dependency: peer <版本要求> from <第一步的主体包>行：这行直接写明了主体包对冲突包的版本要求，本次报错中要求为@angular/compiler-cli@"^12.0.0"
• 第四步：对比版本要求和实际安装版本，两者不满足语义化版本匹配规则时冲突成立，将两边版本调整至兼容范围即可解决问题。

补充说明：peer依赖本质是“同级依赖”约定——如果包A声明了对包B的peer依赖，npm不会自动为你安装包B，而是要求你在项目根目录手动安装符合版本范围的包B，版本不符合时就会直接抛出ERESOLVE错误。

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