如何将自定义Angular工具包的Rxjs依赖版本与Angular所用版本绑定？

问题背景（中文翻译） #

我正在开发一个轻量级Angular工具包，打算将其发布为npm包。我的包依赖RxJS版本Y，而Angular本身依赖RxJS版本Z。目前Y和Z版本一致，但Angular每6个月会发布大版本，这种版本一致的情况无法长期维持。我的库中RxJS的使用占比极低，而且短期内不会改动。我希望确保就算长时间不更新我的工具包，在Angular项目中使用它时，打包文件里也不会出现两个不同版本的RxJS。请问有没有办法让我的库依赖的RxJS版本自动对齐到项目中Angular所使用的版本？

解决方案 #

• 将RxJS声明为peer依赖（peerDependencies）
  这是最适配你场景的方案。在工具包的package.json中，把RxJS从dependencies迁移到peerDependencies，并指定一个宽泛的兼容版本范围（例如">=7.0.0 <8.0.0"，根据你当前使用的RxJS大版本调整）。这样你的工具包不会自带RxJS，而是直接复用项目中已安装的、与Angular配套的RxJS版本。npm/yarn会自动保证项目中仅存在一个满足peer依赖要求的RxJS版本，从根源避免重复打包。

• 版本覆盖规则（备选）
  若因特殊情况无法使用peer依赖，可在package.json中配置npm的overrides或yarn的resolutions强制指定RxJS版本，但这个方案更适合项目级配置而非库开发。库开发优先推荐peer依赖，因为版本覆盖可能与用户项目的其他依赖产生冲突。

• 保持RxJS API的兼容性
  由于你提到RxJS使用占比极低且短期内无变更，只要你使用的是RxJS的核心稳定API（如Observable、基础操作符map/filter等），跨小版本甚至大版本的兼容性通常都有保障。因此设置宽泛的peer依赖版本范围，足以覆盖Angular未来数次大版本更新的需求。

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