Angular从13升级到14时遭遇peer依赖冲突求助

问题核心 #

当前遇到的npm依赖冲突是因为@angular-devkit/build-angular@14.2.4要求peer依赖@angular/compiler-cli@^14.0.0，但项目中仍保留着@angular/compiler-cli@12.2.16，版本不匹配导致安装失败。手动降级cli或使用--force/--allow-dirty参数会破坏Angular核心包版本一致性，引发更多问题。

错误日志如下：

npm ERR! While resolving: @angular-devkit/build-angular@14.2.4
npm ERR! Found: @angular/compiler-cli@12.2.16
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   dev @angular/compiler-cli@"^12.2.16" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/compiler-cli@"^14.0.0" from @angular-devkit/build-angular@14.2.4
npm ERR! node_modules/@angular-devkit/build-angular
npm ERR!   dev @angular-devkit/build-angular@"^14.2.4" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: @angular/compiler-cli@14.2.4
npm ERR! node_modules/@angular/compiler-cli
npm ERR!   peer @angular/compiler-cli@"^14.0.0" from @angular-devkit/build-angular@14.2.4
npm ERR!   node_modules/@angular-devkit/build-angular
npm ERR!     dev @angular-devkit/build-angular@"^14.2.4" from the root project

解决方案 #

步骤1：清理现有依赖环境

删除旧依赖包和锁文件，清理npm缓存：

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

步骤2：使用Angular官方升级工具（推荐）

Angular的ng update命令会自动处理版本兼容性，同步所有核心包版本：

ng update @angular/core@14 @angular/cli@14

若项目包含其他Angular生态包（如@angular/material），一并升级：

ng update @angular/material@14

步骤3：手动统一Angular包版本（当ng update失败时）

打开package.json，将所有@angular/开头的依赖包版本统一改为^14.2.4，确保版本一致：

{
  "dependencies": {
    "@angular/core": "^14.2.4",
    "@angular/common": "^14.2.4",
    "@angular/forms": "^14.2.4",
    // 其他Angular运行依赖...
  },
  "devDependencies": {
    "@angular/compiler-cli": "^14.2.4",
    "@angular-devkit/build-angular": "^14.2.4",
    "@angular/cli": "^14.2.4",
    // 其他Angular开发依赖...
  }
}

保存后重新安装依赖：

npm install

步骤4：验证升级结果

启动项目确认无报错：

ng serve

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