npm link、Lerna 和 pnpm workspace 是三种不同的工具/功能，用于处理 JavaScript 项目的依赖管理和 Monorepo 场景。它们的核心区别如下：
1. npm link
用途
- 本地调试依赖：将本地开发的包（Package A）临时链接到另一个项目（Project B）中，方便调试和修改，无需发布到 npm。
- 单包场景：适用于简单的依赖调试，不涉及复杂的多包管理。
工作原理
- 在包目录（Package A）中运行
npm link，创建一个全局符号链接。 - 在目标项目（Project B）中运行
npm link package-a，将全局链接指向本地包。
优缺点
- 优点：简单快速，适合临时调试。
- 缺点 ：
- 需要手动管理链接关系。
- 全局符号链接可能导致版本冲突。
- 不支持多包协同管理（Monorepo）。
2. Lerna
用途
- Monorepo 管理：专为管理多包仓库（Monorepo）设计，支持批量操作（构建、测试、发布等）。
- 依赖提升 ：通过
hoisting减少重复依赖安装，优化磁盘空间。 - 版本发布 ：自动化版本号和发布流程，支持语义化版本和
independent模式。
工作原理
- 使用
lerna bootstrap安装所有子包的依赖，并自动链接本地包。 - 使用
lerna run在所有子包中运行脚本（如build、test）。 - 使用
lerna publish发布更新到 npm。
依赖管理
- 默认依赖管理工具为
npm，但可与yarn workspace或pnpm集成。 - 通过
--hoist将公共依赖提升到根目录的node_modules。
优缺点
- 优点 ：
- 强大的 Monorepo 管理能力。
- 支持自动化版本管理和发布。
- 与 Yarn/pnpm 集成灵活。
- 缺点 ：
- 配置复杂。
- 依赖提升可能导致隐式依赖问题。
- 需要额外工具链（如
yarn workspace）优化依赖安装。
3. pnpm workspace
用途
- Monorepo 管理 ：
pnpm内置的 Monorepo 支持，通过workspace协议管理多包依赖。 - 依赖隔离：基于内容寻址存储和硬链接，保证依赖隔离和磁盘高效利用。
工作原理
- 在根目录的
pnpm-workspace.yaml中定义子包路径。 - 使用
pnpm install安装依赖，自动处理本地包链接。 - 通过
workspace:*协议声明子包依赖（自动指向本地版本）。
依赖管理
- 所有依赖存储在全局
store，通过硬链接复用。 - 子包的
node_modules只包含直接依赖，避免依赖提升的副作用。
优缺点
- 优点 ：
- 依赖管理高效，节省磁盘空间。
- 依赖隔离严格，避免版本冲突。
- 无需额外工具，开箱即用。
- 缺点 ：
- 生态工具链（如自动化发布）不如 Lerna 成熟。
- 部分旧工具可能不兼容
pnpm的依赖结构。
核心区别总结
| 工具/功能 | 适用场景 | 依赖管理 | 核心优势 | 典型用例 |
|---|---|---|---|---|
npm link |
单包本地调试 | 全局符号链接 | 简单临时调试 | 调试单个包的修改 |
| Lerna | 复杂 Monorepo | 依赖提升 | 自动化版本发布、多包协同管理 | 大型项目（如 Babel、React） |
| pnpm workspace | 高效 Monorepo | 依赖隔离 | 磁盘高效、严格隔离 | 追求性能和依赖安全的项目 |
如何选择？
- 简单调试 ➜
npm link。 - 复杂 Monorepo + 自动化发布 ➜
Lerna + Yarn/pnpm。 - 高效依赖管理 + 严格隔离 ➜
pnpm workspace。