peerDependencies（对等依赖）是发布 npm 包时最核心、也最容易踩坑的配置之一。
简单来说，它的作用是告诉使用你组件库的人："我的组件运行需要某个依赖（比如 Vue），但我不想把它打包进去，请你（宿主项目）自己提供。"
为了让你彻底搞懂，我们可以从以下三个维度来理解：
🎯 1. 为什么要用 peerDependencies？（核心目的）
- 避免重复安装和打包 ：如果你的组件库把
vue放在普通的dependencies里，第三方安装你的库时，就会在他的node_modules里多装一个 Vue。这会导致项目体积变大，甚至出现"两个 Vue 实例"的诡异 Bug。 - 版本共享与兼容 ：通过声明
peerDependencies，你的组件库会直接使用第三方项目里原本就有的那个 Vue 实例，确保大家用的是同一个版本，既节省空间又保证运行正常。
⚖️ 2. 三种依赖的区别（一张表看懂）
在开发组件库时，分清这三种依赖至关重要：
表格
| 依赖类型 | 谁负责安装？ | 典型场景 | 通俗解释 |
|---|---|---|---|
| dependencies | 你的组件库自带 | axios, lodash 等纯工具库 | "我干活必须用到的工具，我自己带着。" |
| devDependencies | 仅开发时需要 | vite, rollup, eslint | "我造轮子时用的电钻，卖轮子时不用带。" |
| peerDependencies | 使用者（宿主）提供 | vue, react, vue-router | "我用的是你家的电，所以你得保证家里有电（且电压得对）。" |
⚙️ 3. 实际工作中的表现与避坑指南
当你在 package.json 中配置了 "peerDependencies": { "vue": "^3.0.0" } 后，会发生以下情况：
- 警告提示 ：如果第三方在使用你的组件库时，没有安装 Vue，或者安装的 Vue 版本是 2.x（不满足
^3.0.0的要求），npm 或 pnpm 在安装时就会发出警告（WARN），甚至在较新的 npm 版本中直接报错导致安装失败。 - 不会自动安装 ：在大多数情况下，npm 不会帮你自动安装
peerDependencies里的包，而是提醒使用者自己去装。
💡 遇到版本冲突怎么办？
在实际开发中，经常因为各种包的 peerDependencies 要求不一致导致 npm install 报错（依赖树解析失败）。这时可以使用一个经典的"逃生舱"命令：
npm install --legacy-peer-deps
这个参数的意思是告诉 npm："忽略这些对等依赖的版本冲突警告，按照老规矩强行安装就好。"这在解决复杂的依赖冲突时非常管用。
总结一下，作为组件库开发者，把框架类依赖（如 Vue）放入 peerDependencies 是最规范的做法，它能最大程度地保证你的库在各种项目中都能轻量、兼容地运行。