Mono Repo中包版本控制：多React应用能否使用不同版本共享库？

1. MonoRepo完全适配你的场景 #

你的核心需求——复用代码的同时自主控制共享库版本、支持不同应用的独立部署频率——完全可以通过MonoRepo实现，Nx和TurboRepo都原生支持这类场景，不需要放弃MonoRepo带来的复用、统一构建等优势。

2. 实现两个应用使用共享库不同版本的具体方案 #

通用分支隔离思路 #

• 给共享库维护两个核心分支：main分支用于App1的高频迭代更新，同时创建shared-lib/v1-stable这类稳定分支，保留适配App2的旧版本代码
• App1直接依赖main分支的共享库，App2则依赖稳定分支的代码，通过MonoRepo工具的本地依赖机制实现隔离

Nx的操作方式 #

• 开启Nx的独立版本模式，不为整个workspace设置统一版本，而是给共享库单独设置版本号
• 在各应用的package.json里，分别指定共享库的版本约束：

  // app1/package.json
  {
    "dependencies": {
      "@your/shared-lib": "^2.0.0"
    }
  }
  
  // app2/package.json
  {
    "dependencies": {
      "@your/shared-lib": "^1.5.0"
    }
  }
  

• 使用nx affected命令精准构建：更新共享库main分支后，只触发App1的构建部署；App2的构建只会使用它声明的旧版本，不受main分支更新影响
• 还可以通过nx release单独发布共享库的特定版本，不用强制所有应用同步升级

TurboRepo的操作方式 #

• 在TurboRepo的packages目录下，可为共享库的不同版本创建子目录（比如packages/shared-lib-v1、packages/shared-lib-v2），分别维护不同版本的代码
• 在App1和App2的package.json里，分别依赖对应的子目录包：

  // app1/package.json
  {
    "dependencies": {
      "@your/shared-lib": "workspace:^2.0.0"
    }
  }
  
  // app2/package.json
  {
    "dependencies": {
      "@your/shared-lib": "workspace:^1.5.0"
    }
  }
  

• 利用Turbo的filter参数实现隔离构建：
  • 构建App1：turbo build --filter=app1...
  • 构建App2：turbo build --filter=app2...
    两个应用的构建流程完全独立，不会互相影响

3. 实用建议 #

• 尽量不要长期维护过多共享库版本，定期将App2同步到共享库的稳定新版本，减少后续的维护负担
• 给两个应用配置独立的CI/CD流水线：App1的流水线绑定共享库main分支的更新，自动触发构建部署；App2的流水线只在自身代码变更或依赖的稳定分支更新时触发
• 给共享库写清楚版本变更日志，方便跟踪不同版本的差异，降低App2升级时的风险

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