Monorepo（單一倉(cāng)庫(kù)）是一種將多個(gè)相關(guān)項(xiàng)目或模塊存儲(chǔ)在同一個(gè)版本控制倉(cāng)庫(kù)中的代碼管理策略。與傳統(tǒng)的多倉(cāng)庫(kù)（MultiRepo）模式不同，Monorepo 強(qiáng)調(diào)代碼共享、統(tǒng)一管理和跨項(xiàng)目協(xié)作。

核心特點(diǎn)

1. 統(tǒng)一代碼庫(kù)：所有項(xiàng)目共享同一倉(cāng)庫(kù)，目錄結(jié)構(gòu)清晰（如 apps/ 存放應(yīng)用，packages/ 存放共享庫(kù)）。
2. 原子提交：跨項(xiàng)目的變更可通過(guò)一次提交完成，確保版本一致性。
3. 共享依賴：通過(guò)工具（如 Yarn Workspaces、pnpm）統(tǒng)一管理依賴，避免重復(fù)安裝。
4. 統(tǒng)一工具鏈：集中配置構(gòu)建、測(cè)試、代碼規(guī)范（如 ESLint、TypeScript）。

優(yōu)勢(shì)

1. 代碼復(fù)用：跨項(xiàng)目共享代碼（如工具函數(shù)、UI 組件），減少重復(fù)開(kāi)發(fā)。
2. 簡(jiǎn)化依賴管理：避免版本沖突，依賴升級(jí)更高效。
3. 高效協(xié)作：開(kāi)發(fā)者可輕松查看和修改其他項(xiàng)目代碼，促進(jìn)團(tuán)隊(duì)協(xié)作。
4. 優(yōu)化 CI/CD：支持增量構(gòu)建和測(cè)試，減少構(gòu)建時(shí)間（如 Turborepo 的緩存機(jī)制）。
5. 跨項(xiàng)目重構(gòu)：修改公共代碼后，可快速驗(yàn)證所有依賴項(xiàng)目。

劣勢(shì)

1. 倉(cāng)庫(kù)體積大：克隆和拉取速度慢，需優(yōu)化（如 Git LFS 或稀疏檢出）。
2. 權(quán)限管理復(fù)雜：需精細(xì)控制目錄級(jí)訪問(wèn)權(quán)限（如 GitLab Groups）。
3. 構(gòu)建性能挑戰(zhàn)：全量構(gòu)建耗時(shí)，需工具支持增量構(gòu)建（如 Nx、Turborepo）。
4. 工具鏈復(fù)雜度：需配置 Monorepo 專用工具（如 Lerna、Rush）。

使用方式

1. 基礎(chǔ)工具：
   ? Lerna：管理多包版本發(fā)布和依賴鏈接。

   ? Yarn/pnpm Workspaces：解決依賴提升和磁盤占用問(wèn)題。

   ? Turborepo：高性能增量構(gòu)建和緩存。

2. 目錄結(jié)構(gòu)示例：

   my-monorepo/
   ├── apps/
   │   ├── web-app/      # 前端應(yīng)用
   │   └── mobile-app/   # 移動(dòng)端應(yīng)用
   ├── packages/
   │   ├── utils/        # 共享工具庫(kù)
   │   └── ui-kit/       # UI 組件庫(kù)
   ├── package.json      # 根配置（workspaces 聲明）
   └── lerna.json        # Lerna 配置
   

3. 操作流程：
   ? 初始化：npx lerna init + yarn workspaces。

   ? 依賴安裝：yarn install（自動(dòng)鏈接內(nèi)部依賴）。

   ? 構(gòu)建：npx lerna run build（并行執(zhí)行）。

應(yīng)用場(chǎng)景

1. 大型開(kāi)源項(xiàng)目：如 React、Vue 3，管理核心庫(kù)、插件和文檔。
2. 微服務(wù)架構(gòu)：多個(gè)服務(wù)共享通用代碼和配置。
3. 全棧項(xiàng)目：前后端代碼同倉(cāng)，便于接口聯(lián)調(diào)。
4. 多平臺(tái)應(yīng)用：Web、iOS、Android 共享業(yè)務(wù)邏輯。
5. 企業(yè)級(jí)項(xiàng)目：跨團(tuán)隊(duì)協(xié)作，統(tǒng)一開(kāi)發(fā)規(guī)范（如 Google、Facebook）。

工具推薦
? 輕量級(jí)：Yarn/pnpm Workspaces。

? 中等規(guī)模：Lerna + Workspaces。

? 大型項(xiàng)目：Nx（依賴圖可視化）、Turborepo（高性能構(gòu)建）。

總結(jié)
Monorepo 適合中大型團(tuán)隊(duì)或復(fù)雜項(xiàng)目，能顯著提升代碼復(fù)用和協(xié)作效率，但需權(quán)衡倉(cāng)庫(kù)規(guī)模和工具鏈復(fù)雜度。選擇時(shí)需結(jié)合團(tuán)隊(duì)規(guī)模、項(xiàng)目需求及工具生態(tài)。