使用Yarn与Lerna管理monorepo

1,685 阅读2分钟

什么是 Yarn workspace

Yarn workspace 是 Yarn 提供的 monorepo 下,管理依赖的机制。对代码仓库下,多个 package 的依赖,进行管理:将共同的依赖,做 hosting(提升)。这样,可以防止 package 中的包重复安装。 workspace 机制,会在根目录下,统一安装依赖到 node_module,并生成 yarn.lock。单个 package 下,不需要再生成 yarn.lock。

如何使用 Yarn workspace

  1. Yarn 启用工作区
yarn config set workspaces-experimental true

命令的含义:添加workspaces-experimental true到系统全局的.yarnrc中。

2.修改根目录的 package.json,添加如下内容:

{
 "private": true,
 ...
 "workspaces": ["packages/*"]
}

配置项含义: private - 禁止发布根目录内容 workspaces - 设置工作区,声明 workspace 中 package 的路径。值是一个字符串数组,支持 Glob 通配符。

Lerna 安装依赖的方式

Lerna 安装依赖的方式,是使用命令lerna bootstrap。 该命令的作用,是 cd 到 package 文件夹下的每个子文件夹,运行npm installyarn install,在子文件夹中生成版本lock文件node_module,单独对依赖进行管理。

Yarn workspace 与 Lerna 结合

结合的方式

  1. 配置 lerna.json
{
 ...
 "npmClient": "yarn",
 "useWorkspaces": true
}
  1. 配置 package.json
{
 "private": true,
 ...
 "workspaces": ["packages/*"]
}

角色的分配

Yarn 负责管理依赖,workspace 会自动对 package 的引用 ,设置软链接(symlink),并且软链接仅在当前 workspace 中生效。 Lerna 负责版本的发布工作,对 package 相互之间的依赖,做好版本管理。

好处

  • 减少项目的磁盘占用空间

    Yarn 将项目中的共同依赖,提升到根目录下进行安装

  • 自动设置软链接,方便调试

    Yarn 的 workspace 会自动对 package 的引用,设置 symlink

  • 所有 package 使用同一个 yarn.lock,更少造成冲突且易于审查

使用

  • 首次安装依赖 lerna bootstrap
  • 安装 workspace 下的 dependencies 依赖 yarn add -W [pkg]
  • 安装 workspace 下的 devDependencies依赖 yarn add -D -W [pkg]

-W 的含义: 安装依赖到workspace
-D的含义: 安装依赖到devDependencies

  • 查看项目中的workspace依赖树 yarn workspaces info
  • 添加开发环境依赖到某个子项目 yarn workspace [workspace name] add [pkg] --dev
  • 添加生产环境依赖到某个子项目 yarn workspace [workspace name] add [pkg]