开发类库时，如何处理依赖项的peer dependencies？

针对你开发类库时遇到的pnpm安装报错问题（依赖自带peer依赖但你的类库未使用），可以按以下优先级尝试方案：

1. 开启pnpm自动安装peer依赖（开发阶段快速解决） #

在项目根目录创建或修改.npmrc文件，添加：

auto-install-peers=true

这个配置会让pnpm自动安装依赖所需的peer依赖，直接解决安装报错。适合开发阶段快速推进，注意：发布类库时无需将此配置打包，因为你的类库本身不依赖这些peer依赖，用户安装你的包时不会受此影响。

2. 标记依赖的peer依赖为可选（更规范的类库开发方式） #

如果不想自动安装多余依赖，可以在你的package.json中声明那些未使用的peer依赖，并标记为可选：

"peerDependencies": {
  "xxx-dep": "^1.0.0" // 替换为实际的peer依赖包名和版本
},
"peerDependenciesMeta": {
  "xxx-dep": {
    "optional": true
  }
}

这样pnpm会跳过对该peer依赖的强制检查，既解决报错，又符合类库的依赖声明规范——明确告知包管理器这些依赖不是你的类库必须的。

3. 尝试依赖提升（极端情况备选） #

如果上述方案无效，可以在.npmrc中添加：

shamefully-hoist=true

这个配置会将所有依赖提升到node_modules根目录，模拟npm的依赖扁平化行为，可能解决某些依赖找不到peer依赖的问题。但这是比较hack的方式，可能引发版本冲突，仅在必要时使用。

4. 替换或更新依赖（根源解决） #

查看带问题peer依赖的包是否有更新版本，新版本可能移除了不必要的peer依赖；或者寻找功能类似、依赖更简洁的替代包，从根源避免peer依赖问题。

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