罗罗编程学习记录
本页内容 展开查看

03.6.2.1 Monorepo

所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.6 前端工程化 / 03.6.2 Monorepo 与组件库发布

覆盖范围

  • Monorepo 概念:单仓库多包、依赖共享
  • pnpm workspace:硬链接、幽灵依赖隔离
  • Turborepo:任务编排、缓存、并行
  • Nx:高级依赖图、生成器
  • Lerna:版本管理与发布

高频题速览

编号 题目 难度 频率
03.6.2.1-001 pnpm workspace 与 npm workspace 区别 进阶 ★★★★
03.6.2.1-002 幽灵依赖是什么,pnpm 如何解决 进阶 ★★★★
03.6.2.1-003 Turborepo 与 Nx 选型 进阶 ★★★
03.6.2.1-004 Monorepo 版本管理策略 进阶 ★★★
03.6.2.1-005 pnpm workspace 配置示例 基础 ★★★
03.6.2.1-006 Monorepo 部署单个应用 进阶 ★★★
03.6.2.1-007 Lerna 与 changesets 区别 进阶 ★★
03.6.2.1-008 Monorepo 与 Polyrepo 选型 基础 ★★★

03.6.2.1-001 pnpm workspace 与 npm workspace 区别

一句话结论

pnpm 用硬链接 + 符号链接节省磁盘,隔离幽灵依赖;npm/yarn workspace 用扁平 node_modules,可能产生幽灵依赖。

概念解释

  • pnpm:内容寻址存储 + 硬链接。
  • npm workspace:扁平 node_modules。

原理流程

  1. pnpm 全局 store 存包。
  2. 项目内符号链接到 store。
  3. 包只能访问自己声明的依赖。

代码 / 示例

# pnpm-workspace.yaml
packages:
  - "apps/*"
  - "packages/*"

常见误区

  • 误区:pnpm 慢;正解:pnpm 安装快,因为硬链接。
  • 误区:pnpm 不兼容 npm;正解:package.json 兼容,lockfile 不同。

追问

  • Q:如何从 npm 迁移 pnpm? A:删除 node_modules 与 lock,pnpm import 后 pnpm install。
  • Q:pnpm 如何提升? A:.npmrc 加 shamefully-hoist=true,但会失去隔离。

03.6.2.1-002 幽灵依赖是什么,pnpm 如何解决

一句话结论

幽灵依赖是代码中使用了未在 package.json 声明的包(因为 hoist 到了根 node_modules);pnpm 不 hoist,必须显式声明。

概念解释

  • 幽灵依赖:未声明但能 import。
  • pnpm:严格依赖声明。

原理流程

  1. npm/yarn hoist 所有依赖到根。
  2. 包可以 import 未声明的依赖。
  3. pnpm 严格隔离。

代码 / 示例

// 未在 package.json 声明 lodash,但能 import
import _ from "lodash"; // pnpm 报错

常见误区

  • 误区:幽灵依赖无所谓;正解:hoist 结构变化后 import 失败,难以排查。
  • 误区:pnpm 所有包都要显式声明;正解:是的,这是特性不是 bug。

追问

  • Q:如何兼容老项目? A:shamefully-hoist=true 临时兼容,逐步补声明。
  • Q:如何批量补声明? A:用 eslint-plugin-import 或 knip。

03.6.2.1-003 Turborepo 与 Nx 选型

一句话结论

Turborepo 轻量,任务编排 + 缓存,配置简单;Nx 功能全,依赖图、生成器、代码分析,适合大型组织。

概念解释

  • Turborepo:任务调度。
  • Nx:构建系统全家桶。

原理流程

  1. Turborepo 读取 task 依赖图。
  2. 并行执行 + 缓存。

代码 / 示例

// turbo.json
{
  "pipeline": {
    "build": { "dependsOn": ["^build"], "outputs": ["dist/**"] }
  }
}

常见误区

  • 误区:Turborepo 替代包管理器;正解:Turborepo 是任务编排,仍需 pnpm/npm。
  • 误区:Nx 学习成本低;正解:Nx 概念多,小项目过重。

追问

  • Q:缓存如何工作? A:根据输入 hash 缓存输出,命中则跳过。
  • Q:远程缓存? A:Turborepo 与 Nx 都支持远程缓存(Vercel/Nx Cloud)。

03.6.2.1-004 Monorepo 版本管理策略

一句话结论

版本管理分独立版本(每个包独立版本号)与固定版本(所有包同步版本);changesets 管理独立版本,Lerna 支持两者。

概念解释

  • 独立版本:每个包单独发版。
  • 固定版本:所有包同版本号。

原理流程

  1. 开发时 changeset 记录变更。
  2. 发版时按 changeset 更新版本与 changelog。

代码 / 示例

npx changeset
npx changeset version
npx changeset publish

常见误区

  • 误区:所有包同步版本;正解:UI 组件库独立版本,应用固定版本。
  • 误区:版本号手动改;正解:用 changesets 自动生成。

追问

  • Q:依赖包版本? A:workspace 协议 workspace:*,发版时替换为实际版本。
  • Q:如何预览发版? A:changeset version 在 dry-run。

03.6.2.1-005 pnpm workspace 配置示例

一句话结论

根目录 pnpm-workspace.yaml 定义包路径,各包 package.json 通过 workspace:* 引用内部包。

概念解释

  • workspace 协议:workspace:* 或 workspace:^1.0.0。

原理流程

  1. 根目录配置。
  2. 包内引用。
  3. pnpm install 时符号链接。

代码 / 示例

{
  "dependencies": {
    "@ann/ui": "workspace:*"
  }
}

常见误区

  • 误区:workspace:* 发布到 npm 报错;正解:changesets 会替换为实际版本。
  • 误区:内部包需要发布才能用;正解:workspace 内直接符号链接,不发布。

追问

  • Q:如何引用内部包? A:workspace:*,发版时替换。
  • Q:内部包如何构建? A:Turborepo 自动按依赖顺序构建。

03.6.2.1-006 Monorepo 部署单个应用

一句话结论

Monorepo 部署单个应用:根据改动文件判断影响范围,只构建受影响应用;Docker 构建上下文只包含应用与依赖包。

概念解释

  • 影响范围:Turborepo --filter。
  • Docker:多阶段构建。

原理流程

  1. CI 判断改动。
  2. 只构建受影响应用。
  3. Docker 打包。

代码 / 示例

turbo run build --filter=web

常见误区

  • 误区:Monorepo 每次构建所有;正解:按 filter 与缓存只构建改动。
  • 误区:Docker 构建整个仓库;正解:构建上下文只包含必要文件。

追问

  • Q:如何判断影响? A:Turboreola 基于依赖图自动判断。
  • Q:CI 缓存? A:远程缓存跨 CI 命中。

03.6.2.1-007 Lerna 与 changesets 区别

一句话结论

Lerna 是全功能 Monorepo 工具(版本 + 发布),changesets 专注版本与 changelog;现代推荐 pnpm + Turborepo + changesets。

概念解释

  • Lerna:一体化。
  • changesets:轻量版本管理。

原理流程

  1. Lerna 自带 bootstrap 与 publish。
  2. changesets 只管理版本。

代码 / 示例

# Lerna
npx lerna version
# changesets
npx changeset version

常见误区

  • 误区:Lerna 过时;正解:Lerna v7 已与 Nx 集成,仍可用。
  • 误区:changesets 不能发布;正解:changeset publish 发 npm。

追问

  • Q:如何选? A:新项目用 changesets,老 Lerna 项目可迁移。
  • Q:changesets 与 Lerna 版本策略? A:都支持独立版本。

03.6.2.1-008 Monorepo 与 Polyrepo 选型

一句话结论

Monorepo 适合团队共享代码、统一版本、跨包重构;Polyrepo 适合独立团队、独立发布、严格权限。

概念解释

  • Monorepo:单仓库多包。
  • Polyrepo:多仓库。

原理流程

  1. Monorepo:代码共享容易。
  2. Polyrepo:独立发布。

代码 / 示例

Monorepo:
  apps/web
  packages/ui
  packages/utils

Polyrepo:
  repo-web
  repo-ui
  repo-utils

常见误区

  • 误区:Monorepo 一定更好;正解:大仓库 CI 慢、权限复杂,Polyrepo 更灵活。
  • 误区:Monorepo 不能独立发布;正解:changesets 独立发版。

追问

  • Q:Google 用什么? A:Monorepo(Piper),但工具自研。
  • Q:中小团队如何选? A:Monorepo 降低沟通成本。

03.6.2.1-009 pnpm workspace 的依赖提升与幽灵依赖

一句话结论

pnpm 用硬链接 + 符号链接存储依赖,严格依赖隔离避免幽灵依赖;hoist 配置可提升公共包到根 node_modules。

概念解释

  • 幽灵依赖:package.json 没声明但能 import 的包。
  • hoist:提升依赖到根 node_modules。

原理流程

  1. pnpm 把所有包存到全局 store。
  2. 项目内用符号链接引用。
  3. 严格模式下只有 package.json 声明的包能 import。

代码 / 示例

# .npmrc
shamefully-hoist=true  # 模拟 npm/yarn 的 hoist

常见误区

  • 误区:pnpm 一定比 npm 慢;正解:冷启动慢,后续因硬链接更快。
  • 误区:幽灵依赖没问题;正解:换包管理器可能崩。

追问

  • Q:如何解决幽灵依赖? A:package.json 补声明。
  • Q:pnpm 与 turbo 配合? A:turbo 负责任务编排,pnpm 负责依赖。

待整理清单

  • [ ] Monorepo CI 优化
  • [ ] 包发布前检查
  • [ ] 私有 npm 与 verdaccio

关联与延伸

  • 与 03.6.1.1 模块规范与依赖管理、03.6.1.5 CI/CD 与产物优化配合阅读。
  • 幽灵依赖是 pnpm 解决 npm/yarn 痛点的核心特性,面试高频。
  • Monorepo 选型需结合团队规模与工程成熟度,非银弹。

面试准备要点

  • 必须说清 pnpm 与 npm workspace 区别:硬链接 + 幽灵依赖隔离。
  • 必须理解幽灵依赖:未声明但能 import,pnpm 严格隔离。
  • 常见追问:Turborepo 与 Nx 选型?答:Turborepo 轻量,Nx 功能全。
  • 常见追问:版本管理策略?答:独立版本用 changesets,固定版本同步发版。
  • 常见追问:workspace:* 协议?答:内部包引用,发版时替换。
  • 常见追问:Monorepo 部署单个应用?答:--filter + 远程缓存。
  • 常见追问:pnpm 与 npm workspace 区别?答:硬链接 + 幽灵依赖隔离。
  • 常见追问:如何从 npm 迁移 pnpm?答:删除 node_modules,pnpm import 后 install。
  • 常见追问:Monorepo 与 Polyrepo 选型?答:共享代码用 Monorepo,独立团队用 Polyrepo。
  • 常见追问:幽灵依赖是什么?答:未声明但能 import,pnpm 严格隔离。
  • 常见追问:Turborepo 缓存原理?答:输入 hash 缓存输出,命中则跳过。
  • 常见追问:changesets 作用?答:记录变更,自动更新版本与 changelog。