升级Angular项目遭遇‘requires a peer of’依赖错误求助

我之前升级Angular时也碰到过完全一样的问题，给你一步步拆解解决思路：

为什么npm不自动处理对等依赖？ #

从npm 3.x版本开始，官方就取消了自动安装对等依赖（peer dependencies）的机制。原因很简单：不同的第三方包可能依赖不同版本的同一个对等包，如果npm自动安装，很容易出现版本冲突，导致项目运行崩溃。所以现在npm会把版本匹配的选择权交给开发者，也就是你看到的“requires a peer of”提示。

搞定Angular对等依赖问题的正确姿势 #

你单独安装@angular/core和@angular/common的方式不对，因为Angular是一套完整的框架，核心包（core、common、router、forms、compiler等）必须保持完全一致的版本，单独升级一两个包必然会触发依赖不匹配的警告。推荐用下面两种方法：

方法1：用Angular官方升级工具（最稳妥） #

Angular CLI自带的升级工具会自动帮你处理所有依赖版本的匹配问题，这是官方推荐的方式：

1. 先全局安装最新版Angular CLI：

   npm install -g @angular/cli@latest
   

2. 进入你的项目根目录，运行升级命令：

   ng update @angular/core @angular/cli
   

   如果是跨大版本升级（比如从Angular 13升到16），工具会提示你分步升级，跟着提示操作就行。

方法2：手动统一安装所有核心包 #

如果你不想用CLI工具，要确保所有Angular核心包都装同一个最新版本，一次性执行这个命令：

npm install @angular/{core,common,router,forms,compiler,platform-browser,platform-browser-dynamic}@latest -S

这样能保证所有核心包版本一致，避免对等依赖警告。

关于npm回滚警告的处理 #

那个npm WARN rollback警告大多时候是无害的，一般是安装过程中某个临时文件被占用、或者权限不足导致回滚操作失败。可以试试这些解决办法：

• 清理npm缓存：

  npm cache clean --force
  

• 删除项目根目录的node_modules文件夹和package-lock.json文件，然后重新执行安装命令
• 确保没有其他进程占用node_modules（比如IDE的实时预览、其他终端的npm进程）
• 如果是Windows系统，尝试用管理员身份打开终端；macOS/Linux可以加sudo重新运行安装命令（注意sudo谨慎使用，避免后续权限问题）

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