如何实现客户端安装React库时自动安装其peer依赖？

包管理器（npm、yarn、pnpm）默认不会自动安装peerDependencies——这是设计上的考量，目的是让用户自主控制依赖版本，避免版本冲突。但如果需要强制实现自动安装，有两种可行方案：

方案1：用install-peers-cli配合postinstall脚本（推荐） #

这个方案不需要用户手动执行额外命令，完全自动触发：

1. 在你的组件库项目里，把install-peers-cli作为正式依赖安装（不能是devDependency，因为用户安装你的库时需要这个工具在他们的环境里运行）：

   npm install install-peers-cli --save
   

2. 在库的package.json中添加postinstall脚本，同时确保peerDependencies已经正确声明：

   {
     "scripts": {
       "postinstall": "install-peers"
     },
     "peerDependencies": {
       "react": "^18.0.0",
       "react-dom": "^18.0.0",
       "@angular/core": "^16.0.0"
     }
   }
   

当用户执行npm install your-library时，包管理器会先安装你的库及依赖（包括install-peers-cli），然后自动跑postinstall脚本，把所有peerDependencies里的包装到用户项目中。

方案2：把peer依赖同时放进dependencies（不推荐） #

你可以把需要的peer依赖同时加到dependencies字段里，这样包管理器会自动安装它们，但这个方案有明显风险：

• 可能导致用户项目中出现同一依赖的多个版本（比如用户已经装了React 18，你的库又强行装了一份指定版本的React），很容易引发运行时错误（比如React Hooks的版本冲突问题）。
• 违背了peerDependencies的设计初衷，没法让用户自主控制依赖版本，对于Angular这类对版本一致性要求极高的框架，踩坑概率很大。

额外注意点 #

• 一定要给peerDependencies设置合理的版本范围（比如用^表示兼容小版本升级），别强制安装过高或过低的版本，避免破坏用户项目的兼容性。
• 针对Angular项目，要确保@angular/core、@angular/common这类核心包的版本范围一致，避免出现版本不匹配的问题。
• 如果用pnpm，要确认它的postinstall脚本执行规则，确保脚本能正常触发（pnpm默认会执行第三方包的postinstall脚本）。

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