执行npm install安装@angular-devkit/build-angular时遭遇ERESOLVE依赖冲突问题求助

问题分析 #

从你提供的错误信息和依赖清单来看，核心问题是Angular工具链版本不匹配：

• 你的项目基于Angular 20.2.x系列构建，但尝试安装的@angular-devkit/build-angular@20.2.0要求的peer依赖（如@angular/compiler-cli@20.2.3）与你现有依赖版本（@angular/compiler-cli@20.2.2、@angular/compiler@20.2.2）存在冲突。
• 另外注意到你的devDependencies中已经包含@angular/build@^20.2.1——在Angular 17及以后的版本中，@angular/build已经取代@angular-devkit/build-angular成为官方推荐的构建工具，它内部已经集成了@angular-devkit/build-angular的全部功能，通常不需要手动单独安装后者。

解决方案 #

方案1：移除手动安装@angular-devkit/build-angular的需求（推荐）

既然你已经安装了@angular/build@^20.2.1，直接使用它即可，无需额外安装@angular-devkit/build-angular：

1. 如果已经尝试安装过它，先卸载：

npm uninstall @angular-devkit/build-angular --save-dev

2. 直接运行现有构建/开发命令即可（比如ng build、ng serve），@angular/build会自动处理底层依赖。

方案2：统一所有Angular相关依赖版本（解决冲突的根本方法）

如果因为某些场景确实需要安装@angular-devkit/build-angular，必须保证所有Angular核心包和工具包版本严格对齐：

1. 升级所有Angular核心依赖到同一小版本（比如20.2.3，匹配冲突提示中的要求）：

npm install @angular/common@20.2.3 @angular/compiler@20.2.3 @angular/core@20.2.3 @angular/forms@20.2.3 @angular/platform-browser@20.2.3 @angular/router@20.2.3 @angular/compiler-cli@20.2.3 --save

2. 升级Angular工具链依赖到相同版本：

npm install @angular/build@20.2.3 @angular/cli@20.2.3 --save-dev

3. 安装匹配版本的@angular-devkit/build-angular：

npm install @angular-devkit/build-angular@20.2.3 --save-dev

方案3：清理缓存并重新安装（解决残留依赖问题）

如果上述操作后仍有冲突，尝试清理npm缓存和本地依赖后重装：

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

关键提示 #

Angular生态的版本兼容性要求非常严格，所有@angular/*开头的核心包、工具包的主版本和次版本必须完全一致（比如都用20.2.x系列，且x的数值相同），才能避免这类peer依赖冲突问题。

内容来源于stack exchange