前端工程化實踐中，Monorepo（單倉庫）管理和Lerna是兩種流行的方式，用於大型項目或組件庫的組織和版本管理。

Monorepo簡介

Monorepo（單倉庫）是指在一個Git倉庫中管理多個相關項目的開發方式。這種方式的優點在於：

集中式管理：所有項目都在一個倉庫中，方便代碼共享、版本同步和協同開發。
模塊化：可以創建獨立的模塊，方便複用和維護。
統一的CI/CD：一次配置，全倉庫生效，簡化持續集成和部署流程。
更好的依賴管理：可以更容易地管理項目間的依賴關係。

Lerna簡介

Lerna是一個命令行工具，用於在Monorepo中管理多包項目。它提供了版本管理和發佈功能，使得在單個倉庫中管理多個npm包變得簡單。

Lerna的核心概念有：

• Packages：Monorepo中的獨立npm包。
• Versions：每個包可以有自己的版本，可以是固定的或共享的。
• Bootstrapping：初始化所有包的依賴關係，確保每個包都能正常工作。
• Publishing：發佈包到npm，可以是逐個包發佈，也可以是批量發佈。

安裝Lerna

首先，確保安裝Node.js和npm。然後，在項目根目錄安裝Lerna：

npm install --save-dev lerna
# 或
yarn add --dev lerna

初始化Lerna項目

在項目根目錄運行以下命令初始化Lerna：

npx lerna init

這將創建一個lerna.json配置文件和一個packages目錄，用於存放各個包。

創建和管理包

在packages目錄下創建新包：

mkdir packages/my-package
cd packages/my-package
npm init -y
# 或
yarn init -y

在包內編寫代碼，例如index.js和package.json。

使用Lerna命令

Bootstrap：初始化所有包的依賴關係。

  npx lerna bootstrap

Add：在包之間添加依賴。

  npx lerna add @scope/my-package

Publish：發佈包到npm。

  npx lerna publish

List：查看項目中的包。

  npx lerna ls

Lerna配置

在lerna.json中，可以配置Lerna的行為，例如：

{
  "version": "independent", // 或 "fixed"
  "packages": ["packages/*"],
  "command": {
    "publish": {
      "ignore": ["**/node_modules/**"]
    }
  }
}

• version：指定版本策略，可以是fixed（所有包共享同一版本號）或independent（每個包有自己的版本號）。
• packages：指定包含包的目錄路徑。
• command.publish.ignore：在發佈時忽略的文件或目錄。

性能優化

• 獨立版本：使用independent版本策略，可以單獨發佈每個包，避免不必要的發佈。
• Selective Publishing：使用--since或--scope參數，只發布更改的包。
• Workspaces：配合Yarn Workspaces使用，減少安裝時間和磁盤空間佔用。

Lerna的高級特性

異步操作和鎖定

Lerna支持異步操作，這在處理大型項目時非常有用。在lerna.json中設置concurrency屬性可以限制併發執行的任務數量，防止資源過度消耗。

{
  "concurrency": 4
}

Lerna還使用npm的package-lock.json或yarn.lock文件來確保每次安裝時的依賴一致性。當lerna bootstrap執行時，它會按照文件中的鎖定版本安裝依賴，保證所有開發者在本地構建時使用相同的依賴版本。

自定義腳本

Lerna允許在lerna.json中定義自定義腳本，以便在項目中執行特定任務。例如，創建一個預發佈腳本：

{
  "scripts": {
    "prepublishOnly": "tsc"
  }
}

這將在發佈包之前運行TypeScript編譯器。

工作流集成

Lerna可以與常見的CI/CD工具（如Jenkins、CircleCI、GitHub Actions等）集成，實現自動化測試、構建和發佈。在.gitlab-ci.yml、.travis.yml或其他CI配置文件中，配置相應的Lerna命令。

例如，在GitHub Actions中：

name: CI

on:
  push:
    branches: [ main ]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Install Dependencies
      run: npm ci
    - name: Bootstrap Lerna
      run: npm run bootstrap
    - name: Run Tests
      run: npm test
    - name: Publish
      if: startsWith(github.ref, 'refs/tags')
      run: npx lerna publish from-git --yes

Monorepo的最佳實踐

• 清晰的模塊劃分：確保每個包都有明確的邊界和用途，避免過度耦合。
• 版本策略：根據項目需求選擇固定或獨立版本策略。
• 合理的依賴管理：避免循環依賴，合理控制公共依賴。
• 文檔和説明：為每個包提供清晰的README和API文檔，方便其他開發者使用。
• 持續集成：集成自動化測試、代碼質量檢查和構建過程。
• 代碼審查：確保代碼質量和遵循團隊規範。
• 定期清理：定期評估和刪除不再使用的包。

其他Monorepo管理工具

除了Lerna，還有其他一些工具可以用於Monorepo管理，每個工具都有其特點和適用場景：

Yarn Workspaces

Yarn的Workspaces特性直接內置在包管理器中，無需額外的命令行工具。它允許在一個倉庫中管理多個依賴，並自動解決跨包依賴。Workspaces適合那些主要使用Yarn作為包管理器的項目。

Rush (Pika)

Rush是Microsoft開發的一個Monorepo管理工具，專注於速度和可擴展性。Rush使用自定義的依賴解析算法，支持多項目和多包類型，包括TypeScript、JavaScript、C++等。Rush還提供了豐富的命令行工具和配置選項。

Nx ( Nrwl.io)

Nx 是一個開源的Monorepo管理工具，最初為Angular項目設計，但現在支持多種框架和技術，如React、Vue、Node.js等。Nx 提供了一整套工作流工具，包括代碼生成、測試、性能分析和並行構建。它還支持微前端架構。

Monorepo的挑戰

雖然Monorepo有許多優點，但也存在一些挑戰：

• 版本衝突：在大型項目中，管理不同包的版本可能會變得複雜。
• 構建時間：隨着項目規模的增長，構建和測試的時間可能顯著增加。
• 學習曲線：新成員可能需要更多時間來熟悉Monorepo的結構和工作流程。
• 依賴管理：解決跨包依賴和避免循環依賴可能需要額外的注意。

選擇Monorepo還是Polyrepo？

選擇Monorepo還是Polyrepo（多倉庫）取決於項目需求、團隊規模和偏好。Monorepo適合需要頻繁共享代碼和組件的大型項目，而Polyrepo則適用於小項目或需要獨立開發和發佈的組件。

在做出決定時，應考慮以下因素：

• 代碼共享：如果項目間有很多共享代碼，Monorepo可能是更好的選擇。
• 團隊協作：如果團隊需要緊密合作，Monorepo可以簡化協同開發。
• 構建時間：如果項目很大，Monorepo可能導致較長的構建時間。
• 項目獨立性：如果項目彼此獨立，Polyrepo可能更合適。

2500G計算機入門到高級架構師開發資料超級大禮包免費送！