从GitHub拉取项目执行npm install出现上游依赖错误如何解决

从GitHub拉取创建于数月前的旧项目，执行npm install命令时弹出上游依赖冲突错误，报错信息如下：

需求为不做额外的依赖升级改造，仅需在本地成功运行项目。

按优先级从高到低尝试即可：

• 优先使用旧版peer依赖校验逻辑安装（成功率最高，无额外副作用）
  直接在项目根目录执行带参数的安装命令：

npm install --legacy-peer-deps

该参数针对npm v7及以上版本默认开启严格peer依赖校验的机制，回退到npm v6时期的依赖安装逻辑，不会强制要求peer依赖版本完全匹配，完全按照项目初始锁定的依赖树结构安装，适配数月前创建的旧项目场景，安装完成后直接执行项目配置的启动命令（可查看package.json内scripts字段的配置，常见为npm run dev或npm start）即可运行。

• 若上述方案执行后仍报错，可尝试强制安装
  执行命令：

npm install --force

该参数会强制npm忽略本地已存在的依赖冲突副本拉取依赖，注意该方式可能拉取到不符合项目预期的依赖版本，仅在上一个方案失效时尝试。

• 若前两个方案均失效，先匹配Node版本再安装
  旧项目依赖安装失败大概率和本地Node版本与项目开发时版本不匹配有关：
  1. 如果项目根目录存在.nvmrc文件，先执行nvm use切换到项目指定的Node版本
  2. 如果没有.nvmrc配置文件，切换到Node 16 LTS版本（多数半年到1年前前端项目的通用兼容版本）
  3. 版本切换完成后，再执行第一条npm install --legacy-peer-deps命令安装依赖即可

提示：仅本地临时运行项目时，不要随意修改package.json内的依赖版本号，很容易触发连锁的API兼容报错，额外增加项目跑通的成本，优先使用参数绕过依赖校验的方式效率最高。

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