单体仓库 vs 多仓库：该如何选择？

在开发复杂的软件项目时，选择 Monorepo 还是 Polyrepo 会对团队的生产力和代码的可扩展性产生重大影响。本文将分析两者的区别、优缺点，并帮助你判断哪种方式更适合你的需求。

什么是 Monorepo 和 Polyrepo？

Monorepo

Monorepo（单体仓库）是指将多个项目、服务或包的源代码集中在一个仓库中，通常这些项目彼此相关。

my-monorepo/
  packages/
    frontend/
    backend/
    shared/
  package.json
  turbo.json

Polyrepo

Polyrepo（多仓库）则是每个项目、服务或包都有自己独立的仓库。

repos/
  frontend/
    package.json
  backend/
    package.json
  shared/
    package.json

视觉差异

优缺点对比

Monorepo

优点：

• 便于代码共享（如共享库）。
• 可对多个项目进行原子化重构。
• 依赖和配置集中管理。

缺点：

• 随着代码量增长，仓库可能变得臃肿。
• 需要工具来管理部分构建/测试（如 Nx、Turborepo）。

Polyrepo

优点：

• 每个团队/项目独立。
• 小型项目更易管理。
• 可实现更细粒度的访问策略。

缺点：

• 代码共享困难，需发布包。
• 跨仓库重构更复杂。
• 配置可能重复。

实践案例：使用 Turborepo 的 Monorepo

假设你想用 Turborepo 创建一个包含前端和后端的 Monorepo。

1. 初始化 Monorepo

npx create-turbo@latest

2. 典型结构

my-monorepo/
  apps/
    web/        # 前端 Next.js
    api/        # 后端 Node.js/Express
  packages/
    ui/         # 共享组件库
    utils/      # 共享函数
  turbo.json
  package.json

3. package.json 中的 workspace 示例

{
  "private": true,
  "workspaces": [
    "apps/*",
    "packages/*"
  ]
}

4. 共享库的导入示例

假设你在 packages/utils/src/formatDate.ts 中有一个函数：

// packages/utils/src/formatDate.ts
export function formatDate(date: Date): string {
  return date.toLocaleDateString('zh-CN');
}

在前端：

// apps/web/pages/index.tsx
import { formatDate } from '@myorg/utils';

export default function Home() {
  return <div>今天是 {formatDate(new Date())}</div>;
}

何时选择 Monorepo？

• 中大型团队，需协作多个相关项目。
• 需要共享代码并进行大规模重构。
• 项目增长快，需要优化构建/测试。

何时选择 Polyrepo？

• 小型或独立项目。
• 不同团队分别开发不同产品。
• 访问权限要求极高。

结论

没有适合所有人的完美方案。选择取决于团队规模、项目复杂度和协作需求。关键是了解权衡，并选择合适的工具来管理复杂性。