Yarn+Lerna Monorepo依赖管理难题：开发与发布矛盾求解

针对你遇到的Monorepo子包依赖在本地开发实时同步和外部应用正常安装的矛盾问题，以下是几个实用的最佳实践方案：

1. 利用Lerna原生本地链接能力（推荐） #

无需手动在package.json中写file://依赖，只需按正常版本号声明子包依赖：

• 在componentA的package.json中，将componentB的依赖写成与Monorepo内componentB一致的版本号，比如：

  "dependencies": {
    "componentB": "^1.0.0"
  }
  

• 运行lerna link命令，Lerna会自动在componentA的node_modules中创建componentB的软链接，实现本地开发时修改componentB后，componentA实时同步变更。
• 发布子包时，直接执行lerna publish，Lerna会自动维护子包间的版本依赖关系，发布后的componentA依赖为正常版本号，外部应用安装时可直接从仓库拉取componentB，无兼容性问题。

2. 结合Yarn Workspaces的工作区依赖协议 #

如果你的项目启用了Yarn Workspaces（可与Lerna配合使用），可以利用Yarn的工作区依赖语法：

• 在componentA的package.json中，将componentB的依赖声明为workspace:协议（Yarn 2+支持）：

  "dependencies": {
    "componentB": "workspace:^"
  }
  

  Yarn 1版本可直接写"componentB": "*"，Yarn会自动识别为本地子包依赖。
• 本地执行yarn install时，Yarn会自动创建本地软链接，保证开发时的实时同步。
• 发布子包时，Yarn或Lerna会自动将workspace:协议替换为对应的具体版本号，确保外部应用安装时依赖解析正常。

3. 开发时手动本地链接，发布前切换版本号 #

适合轻量场景，通过手动链接实现本地开发同步，发布前修正依赖声明：

• 开发阶段：在componentB目录执行yarn link，再到componentA目录执行yarn link componentB，此时componentA会使用本地componentB的软链接，实时同步变更。
• 发布阶段：将componentA的package.json中componentB的依赖从file://（或链接状态）改为对应版本号，执行发布后再改回本地链接配置（可选）。
• 可编写简单脚本自动替换依赖声明，比如用shell脚本替换package.json中的内容，避免手动操作失误。

4. 版本号声明+本地临时链接组合 #

始终在package.json中用版本号声明依赖，开发时临时替换为本地链接：

• 日常开发时，执行yarn add componentB@file:../componentB（或Lerna/Yarn的链接命令）临时切换为本地依赖，实时同步变更。
• 提交代码或发布前，执行yarn add componentB@^1.0.0（对应版本号）恢复正常依赖声明，确保发布后的包能被外部应用正常安装。

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