请解释 npm 中 peerDependency 的概念及其主要用途。

回答思路

1. 【回答框架 1】peerDependency 是 npm 的一种依赖声明方式，用于声明当前包在作为插件时，需要宿主环境（即使用该插件的项目）提供某个具体依赖，且版本需要满足指定范围。它不要求该依赖被自动安装到本包的 node_modules 中，而是期望由宿主项目安装并提供。
2. 【回答框架 2】它的核心作用在于避免同一个依赖被重复安装多份，并确保插件与宿主项目使用同一份依赖实例。典型场景如 React 插件：插件声明 peerDependencies 为 react，这样宿主项目安装的 React 版本与该插件兼容时，插件会直接使用宿主项目中的 React，避免因多个 React 副本导致 hooks 状态不共享等问题。
3. 【回答框架 3】npm 的安装行为是：在安装带有 peerDependency 的包时，如果宿主项目未安装匹配版本的依赖，npm 会在构建依赖树时尝试自动安装（npm 7 及以后），若版本冲突则可能报错或发出警告，需要开发者手动调整版本。而 npm 6 及以前通常只提示警告，不强制安装。
4. 【回答框架 4】使用时需要注意版本范围的声明方式，通常使用宽松的版本范围（如 ^17.0.0），以兼容宿主项目的不同版本。同时，在开发插件时需要在 package.json 中正确列出 peerDependencies，并在文档中说明宿主项目需要安装哪些依赖及其版本要求。
5. 【回答框架 5】对比 dependencies 和 devDependencies，peerDependency 不直接控制本包的依赖安装，而是对宿主项目提出约束，体现了插件化设计中依赖责任分离的原则，让宿主项目决定实际依赖版本，而插件只约定兼容范围。
6. 【关键点 1】peerDependency 声明插件对宿主项目依赖的版本要求，由宿主项目负责安装。
7. 【关键点 2】避免依赖重复安装，确保插件与宿主共享同一依赖实例，尤其对 React 等库很重要。
8. 【关键点 3】npm 7 起在安装时会自动安装缺失的 peerDependency，版本冲突可能导致安装失败。
9. 【关键点 4】声明时使用宽松版本范围以提升兼容性。
10. 【关键点 5】与 dependencies 不同，它不影响本包自身的依赖安装。
11. 【易错点 1】误以为 peerDependency 会自动安装且版本不受宿主影响，实际由宿主决定，冲突时会报错。
12. 【易错点 2】在声明 peerDependency 时只写精确版本，导致宿主项目版本不兼容。
13. 【易错点 3】在开发插件时忘记将宿主需要的依赖添加到 peerDependencies，导致运行时找不到。