前端工程化實踐中，Monorepo（單倉庫）管理和Lerna是兩種流行的方式，用于大型項目或組件庫的組織和版本管理。
2500G計算機入門到高級架構師開發資料超級大禮包免費送！
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: CIon:push:branches: [ main ]jobs:build-and-test:runs-on: ubuntu-lateststeps:- uses: actions/checkout@v2- name: Install Dependenciesrun: npm ci- name: Bootstrap Lernarun: npm run bootstrap- name: Run Testsrun: npm test- name: Publishif: 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計算機入門到高級架構師開發資料超級大禮包免費送！
)
