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。
原理流程
- pnpm 全局 store 存包。
- 项目内符号链接到 store。
- 包只能访问自己声明的依赖。
代码 / 示例
# 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:严格依赖声明。
原理流程
- npm/yarn hoist 所有依赖到根。
- 包可以 import 未声明的依赖。
- 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:构建系统全家桶。
原理流程
- Turborepo 读取 task 依赖图。
- 并行执行 + 缓存。
代码 / 示例
// 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 支持两者。
概念解释
- 独立版本:每个包单独发版。
- 固定版本:所有包同版本号。
原理流程
- 开发时 changeset 记录变更。
- 发版时按 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。
原理流程
- 根目录配置。
- 包内引用。
- 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:多阶段构建。
原理流程
- CI 判断改动。
- 只构建受影响应用。
- 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:轻量版本管理。
原理流程
- Lerna 自带 bootstrap 与 publish。
- 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:多仓库。
原理流程
- Monorepo:代码共享容易。
- 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。
原理流程
- pnpm 把所有包存到全局 store。
- 项目内用符号链接引用。
- 严格模式下只有 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。