目录

1. 介绍
2. 第一章：Lerna 是什么？
   • 为什么选择 Monorepos？
3. 第 2 章：安装和设置 Lerna
   • 先决条件
   • 分步安装指南
   • 设置您的第一个 Lerna 项目
4. 第 3 章：Lerna 中的依赖关系管理
   • 独立依赖关系
   • 提升共享依赖项
   • 引导包
5. 第 4 章：跨包运行脚本
   • 全局执行脚本
   • 定位特定包
6. 第 5 章：使用 Lerna 进行版本控制和发布
   • 固定模式与独立模式
   • 将包发布到 npm
7. 第 6 章：将 Lerna 与 Yarn 工作区结合使用
   • 在 Lerna 中启用 Yarn 工作区
   • 使用 Lerna Yarn 工作区优化工作流程
8. 第 7 章：Lerna 高级用法
   • 过滤命令
   • 创建自定义命令
9. 第 8 章：Lerna Monorepos 最佳实践
   • 逻辑包组织
   • 自动化测试和构建
   • CI/CD 集成
10. 结论
11. 附录：常用 Lerna 命令

介绍

管理涉及多个相互依赖的包的大规模 JavaScript 或 TypeScript 项目对于开发人员和开发团队来说可能是一个重大挑战。通常，开发人员依赖每个包的多个存储库，这会导致代码维护、依赖项管理和协作方面的开销。

Lerna 是一个为管理 monorepos 开发的强大工具，它简化了这一过程。 Monorepos 使团队能够在单个存储库中托管多个包，从而简化依赖关系管理并使团队之间的协作更加顺畅。

这本电子书旨在提供使用 Lerna 有效管理您的 monorepos 的完整指南。无论您处理的是组件库还是具有多个互连包的大型项目，您都会发现有价值的见解，帮助您通过 Lerna 最大限度地提高生产力。

第一章：Lerna 是什么？

Lerna 是一个开源工具，有助于管理 monorepo 中的多个包。它提供了强大的功能，例如自动依赖管理、版本控制和发布，使大规模维护 JavaScript 和 TypeScript 项目变得更加容易。

为什么选择 Monorepos？

Monorepos 是许多大型项目的架构选择，因为它们提供了多种好处：

• 共享代码库：使用 monorepos，代码重用更加容易。这减少了重复并确保项目之间的一致性。
• 简化协作：当所有包都集中在一个地方时，开发人员可以更有效地协同工作。
• 统一构建流程：跨多个包的标准化构建、测试和部署变得更加容易。

尽管有这些好处，管理单一存储库可能会带来独特的挑战，特别是在管理依赖项和版本控制方面。 Lerna 旨在正面应对这些挑战，为 monorepos 提供优化的工作流程。

第 2 章：安装和设置 Lerna

先决条件

开始之前，请确保已安装 Node.js 和 npm（或 Yarn）。 Lerna 与 npm 和 Yarn 兼容。

第 1 步：安装 Lerna

您可以通过npm全局安装Lerna：

npm install --global lerna

或者，您可以将 Lerna 添加为项目中的开发依赖项：

npm install --save-dev lerna

第 2 步：初始化 Lerna Monorepo

安装后，通过导航到项目目录并运行来初始化您的 monorepo：

lerna init

这将创建必要的配置文件，包括 lerna.json，并设置一个包文件夹，您的各个包将驻留在其中。

第 3 步：添加包

在 Lerna 项目中，每个包都位于 packages 下自己的子文件夹中。每个包必须有自己的 package.json 文件用于依赖管理。

结构示例：

/my-project
  /packages
    /package-a
    /package-b
  lerna.json
  package.json

第 3 章：Lerna 中的依赖关系管理

管理多个包之间的依赖关系是 Lerna 的核心优势之一。

独立依赖关系

Lerna 允许您向特定包添加依赖项。例如，如果只有package-a需要lodash，则可以运行：

lerna add lodash --scope=package-a

提升共享依赖项

当多个包共享依赖项时，您可以将这些依赖项提升到 monorepo 的根目录。这减少了冗余并加快了安装速度。要启用提升，请将其添加到 lerna.json:

{
  "hoist": true
}

引导

要安装相互依赖的依赖项和链接包，请运行：

lerna bootstrap

这可确保安装所有必需的外部依赖项，并且包可以正确地相互引用。

第 4 章：跨包运行脚本

Lerna 可以轻松地在 monorepo 中的所有包中执行脚本（例如构建、测试、lint）。

全局执行脚本

要在所有包中运行诸如构建之类的脚本，请使用：

lerna run build

定位特定包

如果您只想运行某些包中的脚本，请使用 --scope 标志：

lerna run test --scope=package-a

这种灵活性可以实现更有针对性的执行，从而节省开发时间。

第 5 章：使用 Lerna 进行版本控制和发布

Lerna 提供强大的版本控制和发布功能，使您可以轻松地版本控制和发布软件包。

1.固定模式

在固定模式下，所有包共享相同的版本号。当任何软件包更新时，所有软件包的版本号都会增加。

2.独立模式

独立模式下，每个包都有自己的版本号。当包更改时，仅更新该包的版本。

切换到独立模式，修改lerna.json:

{
  "version": "independent"
}

发布包

要将包发布到 npm，请运行：

lerna publish

Lerna 将根据您的配置处理版本控制和发布。

第 6 章：将 Lerna 与 Yarn 工作区结合使用

将 Lerna 与 Yarn Workspaces 相结合可以通过提升更多共享依赖项来进一步优化依赖项管理。

要启用 Yarn Workspaces，请修改 lerna.json 文件：

{
  "npmClient": "yarn",
  "useWorkspaces": true
}

然后更新你的package.json：

{
  "workspaces": ["packages/*"]
}

这种集成提高了性能并简化了大型项目的管理。

第 7 章：Lerna 高级用法

过滤命令

Lerna 允许过滤为特定包运行命令或排除某些包。

在特定包上运行的示例：

lerna run build --scope=package-a --scope=package-b

排除包的示例：

lerna run build --ignore=package-c

自定义命令

您可以在 package.json 中为专门的工作流程定义自定义 Lerna 命令。然后可以在您的包中运行这些命令。

第 8 章：Lerna Monorepos 最佳实践

1. 按逻辑组织包：将相关包分组在一起，以便更好地重用代码。
2. 使用提升：提升共享依赖项可以节省空间并加快安装时间。
3. 自动化测试：使用 lerna run 对整个 monorepo 进行自动化测试。
4. CI/CD Pipelines：实施持续集成和部署工作流程以自动测试和部署更改。
5. Yarn Workspaces：利用 Yarn Workspaces 和 Lerna 实现更好的依赖管理。

结论

Lerna 是管理 monorepos 的宝贵工具，提供简化复杂工作流程（从依赖管理到版本控制和发布）的功能。通过采用 Lerna，团队可以降低复杂性、简化流程并改善协作，从而更轻松地维护大型项目。

无论您是在开发简单的组件库还是多包生态系统，Lerna 都能提供有效管理项目所需的工具。继续尝试 Lerna 的高级功能，以释放其全部潜力。

附录：常用 Lerna 命令

• lerna init：初始化 Lerna monorepo。
• lerna bootstrap：安装依赖项和链接包。
• lerna add [package] --scope=[package-name]：添加对特定包的依赖关系。
• lerna run [script]：在所有包中运行脚本。
• lernapublish：将包发布到npm。

快乐编码:)