玩转Lerna，助你轻松搭建Monorepo

什么是Lerna？

Lerna 是一个管理 JavaScript 项目中的多包（monorepo）的工具。它通过促进代码重用、版本同步和依赖管理来简化复杂项目的开发。使用 Lerna，你可以在一个仓库中管理多个项目，且每个项目可以有独立的依赖和配置，这使得大型项目的组织和维护变得更加高效。

为什么选择Lerna？

1. 简化依赖管理

Lerna 提供了内置的工具，用于处理包之间的依赖关系，并确保所有依赖都是最新的。这样可以避免不同包之间版本兼容性的问题。

2. 增强开发效率

在 monorepo 中，开发者可以在内部共享代码，这减少了重复代码的数量，并提高了开发效率。同时，Lerna 允许你一次性运行多个包的测试、构建和发布流程，这在多个项目之间复用代码时十分有用。

3. 强大的版本控制

Lerna 提供了基于标签的版本控制，可以确保项目中所有包版本的一致性。每次发布新版本时，它会自动更新相关包的版本号，并生成相应的变更日志。

安装与初始化Lerna

1. 安装Lerna

要使用 Lerna，首先需要全局安装它。你可以使用以下命令进行安装：

npm install -g lerna

2. 初始化一个Lerna项目

在安装 Lerna 之后，需要初始化一个 Lerna 项目。你可以在一个空目录中运行以下命令：

lerna init

这将创建一个新的 Lerna 项目，生成必要的配置文件和文件夹结构。

3. 配置项目文件

初始化完成后，Lerna 会在项目根目录下生成一个 lerna.json 文件和一个 packages 目录。你可以通过编辑 lerna.json 文件来配置 Lerna 项目的详细信息，例如版本策略、包位置等。

添加与管理包

1. 创建新包

在 Lerna 项目中添加新包非常简单。你只需在 packages 目录下创建相应的包目录，并初始化它们。例如：

mkdir packages/pkg1

cd packages/pkg1
npm init -y

重复上述步骤可以创建多个包。

2. 安装包依赖

在 monorepo 中，每个包可以有各自的依赖。你可以进入对应的包目录，然后使用 npm 或 yarn 安装依赖。例如：

cd packages/pkg1

npm install lodash

3. 链接内部包

在 monorepo 中，不同包之间可以互相引用。Lerna 会自动处理这些内部包的链接。你只需在包的 package.json 文件中声明依赖。例如，如果 pkg1 依赖 pkg2，你可以这样声明：

{

  "name": "pkg1",
  "version": "1.0.0",
  "dependencies": {
    "pkg2": "^1.0.0"
  }
}

之后，运行 lerna bootstrap 来安装并链接所有包的依赖：

lerna bootstrap

管理与发布包

运行脚本

在 monorepo 中，你可以使用 Lerna 一次性运行所有包中的脚本。例如，运行所有包的测试脚本：

lerna run test

发布新版本

当项目准备发布新版本时，你可以使用以下命令来发布所有包的新版本：

lerna publish

Lerna 会自动更新包的版本号，创建 Git 标签，并将包发布到 npm。

总结

Lerna 是一个强大的 monorepo 管理工具，它可以简化复杂项目的依赖管理、版本控制和开发工作流。通过安装与配置 Lerna、创建和管理包以及发布新版本，开发者可以更方便地组织和维护大型项目，从而提升开发效率。