Angular库开发中第三方依赖库的规范管理方案咨询

针对你开发多个Angular库并集成到主应用的场景，依赖的放置规则可以按以下逻辑区分，兼顾最佳实践和你“通用模块主应用统一维护、专属模块随库定义”的需求：

1. 库专属的功能依赖（如X的highcharts、Y的ngx-avatar） #

这类依赖是特定库实现核心功能的必要项，推荐按以下方式处理：

• 优先添加到库自身的peerDependencies：
  把highcharts加到X库的package.json，ngx-avatar加到Y库的package.json的peerDependencies字段中，示例：

  // X库的package.json
  "peerDependencies": {
    "highcharts": "^10.0.0"
  }
  

  这样做的好处是：
  • 强制主应用统一安装和管理这些依赖的版本，避免同一依赖在主应用和库中出现多版本，减少打包体积
  • 契合你“通用模块主应用统一维护”的需求，主应用可以统筹所有库的依赖版本兼容性
• 如果你的库需要被单独发布给其他独立应用使用（而非仅集成到当前主应用），可以同时在库的dependencies中声明该依赖，但在你当前的场景下，这种操作没必要。

2. 通用基础依赖（如@angular/core、rxjs、@angular/common） #

所有Angular库和主应用共享的基础依赖，必须添加到**每个库的peerDependencies**中，而不是dependencies。比如：

// 所有库的package.json都需要包含
"peerDependencies": {
  "@angular/core": "^15.0.0",
  "rxjs": "^7.5.0"
}

原因是Angular要求整个应用中核心包的版本必须完全一致，否则会出现运行时错误。主应用的package.json统一维护这些通用依赖的版本，所有库共享主应用的版本。

3. 库内部私有依赖 #

如果某个依赖仅用于库的内部构建、工具类，不需要主应用提供（比如一些编译时的类型定义、构建工具），则直接添加到库自身的dependencies中即可。

总结 #

• 库专属功能依赖：放对应库的peerDependencies，由主应用统一安装管理
• 通用基础依赖：放所有库的peerDependencies，主应用统一维护版本
• 库内部私有依赖：放对应库的dependencies

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