pnpm install出现：ERR_PNPM_PEER_DEP_ISSUES Unmet peer dependencies

使用 pnpm install 安装项目依赖时出现：ERR_PNPM_PEER_DEP_ISSUES Unmet peer dependencies，在 pnpm github issues 中找到相关解决方案。

一、前言

1. 完整日志

   ERR_PNPM_PEER_DEP_ISSUES Unmet peer dependencies

   .
   └─┬ koa-views
   └─┬ consolidate
   └── ? unmet peer react@^16.13.1: found 18.1.0

   hint: If you don’t want pnpm to fail on peer dependency issues, set the “strict-peer-dependencies” setting to “false”.

2. 问题原因：在 npm 3 中，不会再强制安装 peerDependencies （对等依赖）中所指定的包，而是通过警告的方式来提示我们。pnpm 会在全局缓存已经下载过的依赖包，如果全局缓存的依赖版本与项目 package.json 中指定的版本不一致，就会出现这种 hint 警告。

3. pnpm 团队成员给出的解答：

There are two types of peer deps: optional peer dependencies and non-optional ones. The warnings are only printed for non-optional peer dependencies. If a package works without the peer dependencies, then it should be declared as optional peer dependency. Optional peer dependencies are supported by npm/yarn/pnpm for a long time.

二、处理方案

1. 在项目的 package.json 中配置 peerDependencyRules 忽略对应的警告提示：

   {
   “pnpm”: {
   “peerDependencyRules”: {
   “ignoreMissing”: [
   “react”
   ]
   }
   }
   }

2. 在 .npmrc 配置文件中添加 strict-peer-dependencies=false ，这意味着将关闭严格的对等依赖模式。操作命令如下：

   npm config set strict-peer-dependencies=false

参考链接：

• https://github.com/pnpm/pnpm/issues/4684

---

欢迎访问：天问博客

先自我介绍一下，小编13年上师交大毕业，曾经在小公司待过，去过华为OPPO等大厂，18年进入阿里，直到现在。深知大多数初中级java工程师，想要升技能，往往是需要自己摸索成长或是报班学习，但对于培训机构动则近万元的学费，着实压力不小。自己不成体系的自学效率很低又漫长，而且容易碰到天花板技术停止不前。因此我收集了一份《java开发全套学习资料》送给大家，初衷也很简单，就是希望帮助到想自学又不知道该从何学起的朋友，同时减轻大家的负担。添加下方名片，即可获取全套学习资料哦