入门指南

Lerna 提供了专门的 init 命令，可以帮助您在现有仓库中添加 Lerna，或从头开始创建一个新仓库。

从零开始

在最简单的情况下，lerna init 可用于在空目录中创建新仓库。我们可以运行以下命令：

# 创建一个空目录
mkdir ./new-lerna-workspace
# 进入新目录
cd ./new-lerna-workspace
# 初始化 lerna（使用 --dryRun 预览更改）
npx lerna init --dryRun

请注意，我们在这里传递了 --dryRun 标志，这允许我们预览 lerna init 将对文件系统进行的更改。这使我们可以调整传递给 lerna init 的任何其他参数的值（如 --exact 或 --independent），而无需担心撤消任何错误。

一旦对将要进行的更改感到满意，我们可以简单地重复 npx lerna init 命令，但去掉 --dryRun 标志。

现在，您已经拥有一个可用的 Git 仓库，包括 npm 工作空间，并且可以使用 Lerna 创建、版本化和发布您希望开发的任何包。

在现有仓库中添加 Lerna

如果您已经有一个现有的仓库，仍然可以使用 lerna init 将 lerna 添加到其中。

信息

Lerna 不负责在您的仓库中安装和链接依赖，您的包管理器更适合这项任务。

相反，我们强烈建议配置您选择的包管理器使用其 workspaces 功能：

• npm（https://docs.npmjs.com/cli/using-npm/workspaces）
• yarn（https://yarnpkg.com/features/workspaces）
• pnpm（https://pnpm.io/workspaces）

在现有仓库中初始化 Lerna 时，它需要知道应该操作哪些包。如果您正在使用包管理器的 workspaces 功能（请参见上面的注释），那么 Lerna 将默认使用您已配置的 workspaces 模式。无需额外参数。

或者，您可以使用 lerna init 的 --packages 标志手动指定一组匹配模式：

# 传递单个模式
npx lerna init --packages="packages/*"
# 传递多个模式
npx lerna init --packages="foo/*" --packages="bar/*"