Lerna入门指南：从零开始管理多包项目

Lerna入门指南：从零开始管理多包项目

lerna :dragon: Lerna is a fast, modern build system for managing and publishing multiple JavaScript/TypeScript packages from the same repository. 项目地址: https://gitcode.com/gh_mirrors/le/lerna

什么是Lerna

Lerna是一个强大的工具，专门用于管理包含多个包的JavaScript项目。它能够帮助开发者高效地管理复杂的代码库，特别是那些采用monorepo（单一代码库）结构的项目。通过Lerna，开发者可以轻松地在同一个代码库中维护多个相互关联的包，同时保持版本控制和发布流程的自动化。

环境准备

在开始使用Lerna之前，请确保你的开发环境中已经安装了Node.js和npm（或yarn/pnpm）。Lerna本身是一个Node.js包，可以通过npm全局安装或作为项目依赖使用。

全新项目初始化

1. 创建项目目录

首先，我们需要创建一个空目录作为我们的工作空间：

mkdir my-lerna-project
cd my-lerna-project

2. 初始化Lerna项目

Lerna提供了init命令来初始化一个新项目。在正式执行前，我们可以先使用--dryRun参数预览将要进行的操作：

npx lerna init --dryRun

这个命令会显示Lerna将要创建的文件结构，但不会实际执行任何更改。这是验证配置的好方法。

3. 实际初始化

确认无误后，移除--dryRun参数执行真正的初始化：

npx lerna init

执行完成后，你的项目中将包含以下关键文件：

• lerna.json：Lerna的配置文件
• package.json：项目根目录的npm配置文件
• packages/：默认的包存放目录

在现有项目中集成Lerna

如果你已经有一个现有的项目，也可以轻松地集成Lerna。

1. 初始化Lerna

在项目根目录下运行：

npx lerna init

2. 配置包管理

Lerna需要知道项目中哪些目录包含需要管理的包。如果你使用的是npm/yarn/pnpm的工作区(workspaces)功能，Lerna会自动识别这些配置。

如果没有使用工作区功能，你可以通过--packages参数手动指定：

npx lerna init --packages="packages/*" --packages="components/*"

这个命令告诉Lerna在packages/和components/目录下查找包。

理解Lerna的工作模式

Lerna支持两种版本管理模式：

1. 固定模式(Fixed/Locked mode)：所有包共享同一个版本号
2. 独立模式(Independent mode)：每个包可以独立维护自己的版本号

在初始化时，你可以通过--independent参数选择独立模式：

npx lerna init --independent

最佳实践建议

1. 合理组织包结构：将相关的包放在同一目录下，保持清晰的层级关系
2. 利用工作区功能：结合npm/yarn/pnpm的工作区功能，可以更好地管理依赖
3. 版本控制策略：根据项目需求选择合适的版本管理模式
4. 持续集成：为Lerna项目配置适当的CI/CD流程

下一步

完成初始化后，你可以开始：

• 使用lerna create创建新包
• 使用lerna add添加依赖
• 使用lerna version管理版本
• 使用lerna publish发布包

Lerna的强大功能将帮助你高效管理复杂的多包项目，让开发工作更加顺畅。

lerna :dragon: Lerna is a fast, modern build system for managing and publishing multiple JavaScript/TypeScript packages from the same repository. 项目地址: https://gitcode.com/gh_mirrors/le/lerna