Monorepos可能很痛苦，但這些工具讓你的工作更輕松
原文作者：Fernando Doglio
原文地址：https://itnext.io/the-3-best-monorepo-tools-for-2023-290bd4be8f0b
翻譯：一川
如果沒有正確的工具集，管理 monorepos 通常是一項具有挑戰性的任務。
在單個存儲庫中協調多個項目的復雜性可能會導致以下問題：
- 開發人員的困惑和維護難題。
- 不需要的組件的耦合。
- 發展團隊和項目的復雜性。
- 部署難題。
- 難以單獨對組件進行版本控制，允許它們僅在需要時部署它們。
幸運的是，有一些工具可以簡化單存儲庫的管理并增強開發體驗。
在本文中，我們將探討開發人員可以用來有效處理 monorepos 的前三個工具。每個工具都為常見的單存儲庫問題提供獨特的功能和解決方案。讓我們深入了解這些工具如何簡化您的monorepo管理流程。
RushJS
訪問地址：https://rushjs.io/
RushJS是一個強大的工具，專門設計用于簡化monorepos的管理。它提供了一組正確的功能和命令，使開發人員能夠有效地處理與在單個存儲庫中處理多個項目相關的挑戰。
通過提供高效的依賴關系管理、優化的構建、增強的可擴展性和改進的開發人員體驗，RushJS 使團隊能夠輕松駕馭 monorepo 開發的復雜性。
最重要的是，RushJS是由Microsoft構建的，這在當今往往意味著什么。因此，讓我們來看看如何使用它來解決我們的 Monorepo 頭痛問題。
安裝 RushJS
要安裝RushJS，您所要做的就是使用NPM：
npm install -g @microsoft/rush然后只需在當前項目的文件夾上運行 rush init 即可開始工作。
RushJS的基本用途
正確安裝和配置RushJS后，讓我們快速回顧一下如何在日常工作中使用它。
使用Rush，您需要記住兩個命令： rush 和 rushx。您將用于 rush 所有monorepo級別的操作，例如更新所有依賴項 （ rush update ） 或使用 構建 rush rebuild 整個項目列表。
然后，您將用于 rushx 特定于項目的命令。例如，使用 rush rebuild 構建一個項目后啟動該項目，您可以使用：
cd my-project
my-project> rushx start理解RushJS的關鍵是它是為JavaScript monorepos設計的。看起來你會通過在存儲庫的根部放置大量 package.json 內容來做同樣的事情，但 Rush 并非如此。相反，它使用一組符號鏈接來保持所有項目的更新并同時分開。
如果你正在構建一個JavaScript項目，在其中開發大量單獨的npm包，使用RushJS絕對是一個值得的選擇。
Turborepo
Turborepo是一個強大的工具，專門設計用于簡化monorepos的管理。它提供了一系列特性和功能，可幫助開發人員克服與在單個存儲庫中處理多個項目相關的挑戰。通過提供高效的項目組織、增強的開發工作流程和優化的構建，Turborepo 使團隊能夠有效地處理單存儲庫的復雜性。
Turborepo的關鍵在于它的名字，更準確地說是“turbo”部分。該工具的主要賣點是它使您的工作流程運行得更快。它通過將緩存添加到過程中來實現。源代碼文件將充當哈希函數的輸入，輸出將是日志文件和 stderr 輸出。
也就是說，如果在只有少數文件發生更改的情況下運行構建或測試運行，則該過程將只關注它們，其余文件將從緩存中獲取。
在實踐中，這意味著構建速度非?？?，尤其是一旦項目順利進行并且您只是在推動微小的更改或新功能。
安裝Turborepo
訪問地址：https://turbo.build/repo
安裝 Turborepo 非常簡單，您所要做的就是使用 npm（劇透警報，您還將在下一個工具中使用 NPM）：
npm install turbo -g然后，您可以簡單地進入monorepo中的項目文件夾，并運行如下命令：
cd monorepo/project1
turbo build或者，如果您已經有一個項目并且想要向其添加 Turborepo，請在根級別創建一個turbo.json文件。對于 NextJS 項目，請使用如下配置：
{
"$schema": "https://turbo.build/schema.json",
"pipeline": {
"build": {
"outputs": [".next/**", "!.next/cache/**"]
},
"lint": {}
}
}查看他們的文檔[https://turbo.build/repo/docs/getting-started/add-to-project]，了解如何為其他框架配置它。
Turborepo的基本使用方法
正確安裝和配置 Turborepo 后，讓我們探索它在 monorepo 環境中的基本用法：
項目組織
Turborepo提供了在monorepo中組織項目的有效方法。它允許您定義項目邊界、管理共享依賴項以及維護不同項目之間的明確分離。使用 Turborepo，您可以在 monorepo 中創建單獨的項目目錄，并指定每個項目所需的依賴項。這實現了模塊化和可擴展的結構，從而可以更輕松地管理和維護代碼庫。Turborepo 還提供用于添加、刪除和更新項目的命令，確保在 monorepo 中進行簡單的項目管理。
簡化的開發工作流程
Turborepo 簡化了開發工作流程，可以更輕松地同時處理多個項目。它引入了智能緩存等功能，其中利用以前構建的工件來減少構建時間。通過智能跟蹤更改和重用構建的工件，Turborepo 消除了冗余構建，節省了寶貴的開發時間。開發人員可以通過使用命令turbo build來利用緩存機制，例如僅生成受代碼更改影響的必要組件。這種優化提高了開發速度，尤其是在處理具有互連項目的大型單存儲庫時。
依賴關系管理
Turborepo簡化了單存儲庫中依賴關系的管理。它提供了一種跨項目處理依賴項的統一方法，確保一致且高效的解決方案。Turborepo 利用共享依賴項模型，允許您聲明可在多個項目之間共享的公共依賴項。這消除了跨項目重復依賴項的需要，從而降低了版本沖突的風險并確保了一致性。Turborepo 智能地解析依賴關系，確保為monorepo中的每個項目安裝正確的版本。
優化構建
Turborepo 通過智能識別和僅構建受代碼更改影響的必要組件來優化構建過程。這種增量構建機制顯著縮短了構建時間，使開發人員能夠更快地迭代。Turborepo 跟蹤單存儲庫中的更改并執行選擇性構建，僅重建受代碼修改影響的項目或組件。這種精細的方法最大限度地減少了構建開銷，并確保開發人員可以專注于他們正在處理的代碼庫的特定部分。通過利用優化的構建，開發人員可以加快開發周期并提高生產力。
協作和版本控制
Turborepo 提供的功能可促進單存儲庫設置中的協作和版本控制。它支持項目之間的高效代碼共享，允許團隊在保持明確邊界的同時處理共享組件。Turborepo 通過提供用于在monorepo中創建分支、合并更改和解決沖突的命令來實現協作開發。它還與 Git 等版本控制系統很好地集成，確保有效管理更改和版本歷史記錄。借助 Turborepo，團隊可以無縫協作，增強協作并在 monorepo 中實現高效的版本控制。
通過利用Turborepo的基本使用功能，開發人員可以簡化其 monorepo 工作流程、提高開發速度并保持代碼質量。其直觀的命令和優化的流程使其成為有效管理 monorepos、促進無縫協作和提高整體生產力的寶貴工具。
bit
訪問地址：https://bit.dev/
Bit實際上不是一個單存儲庫管理工具，但它提供了如此出色的體驗，以至于它可以通過它提供的新工作流程解決所有Monorepo“困難”。
管理 monorepos 的主要挑戰之一是保持代碼模塊化，同時確保高效的協作和代碼重用。Bit通過組件驅動開發（CDD）正面解決了這一挑戰。
CDD將組件置于開發過程的中心。開發人員不是從項目或文件的角度來思考，而是專注于創建自包含的、可重用的組件。組件表示可在 monorepo 中的多個項目中使用的特定功能、UI 元素或邏輯。通過采用以組件為中心的方法，Bit 提高了代碼模塊化和可重用性。
安裝Bit
安裝Bit就像編寫一樣簡單：
npx @teambit/bvm install如果您想要更多安裝選項，可以查看他們的文檔站點[https://bit.dev/docs/getting-started/installing-bit/installing-bit/]。
安裝后，您可以通過以下方式開始在項目中使用它：
bit init然后，您可以開始創建工作區，這是一個花哨的詞，表示您將在其中添加組件的文件夾。
每個組件都是使用 Bit創建的，這有助于“正確”設置所有內容：
- 它們將在不同的文件夾中獨立管理。
- 他們將在代碼文件旁邊創建測試和文檔模板。
- 您將能夠單獨對它們進行版本控制。
- 這反過來又使發布它們和重用它們變得非常簡單。
Bit 的基本用法
理解為什么Bit是monorepos的絕佳選擇的關鍵，即使它不是特定于monorepo的工具，因為它提供的DX（開發人員體驗）與對組件驅動開發的支持相結合。
讓我解釋一下。
使用 Bit，您將不會擁有 monorepo，但您會覺得您正在使用實際的 monorepo。
我知道一開始很難理解，所以讓我舉個例子。
假設一個由多個 UI 組件（如按鈕、輸入字段和卡片）組成的項目。傳統上，在 monorepo 設置中，所有這些組件將駐留在單個存儲庫中，從而導致大型而復雜的代碼庫。但是，使用 Bit，開發人員可以將這些組件分解為單獨的實體，每個實體都有自己的開發生命周期。
通過這個詳細的教程[https://bit.dev/blog/how-to-create-a-composable-react-app-with-bit-l7ejpfhc/]了解如何在 React通過bit 創建可組合的應用程序，了解如何做到這一點。
初始化組件
首先，開發人員可以使用Bit的命令行界面（CLI）將每個組件初始化為單獨的實體。例如，他們可以對按鈕組件運行以下命令：
bit create react components/button此命令初始化項目中的按鈕組件，創建專用目錄（如 components/button ），并設置特定于按鈕組件的必要文件和依賴項。
這意味著您的 node_modules 文件夾將有一個指向新組件文件夾的新符號鏈接，這使得從 monorepo 代碼中的任何位置導入和使用它變得非常簡單。
獨立開發組件
使用 Bit，開發人員可以獨立處理每個組件，就像它是一個獨立的項目一樣。他們可以專門針對組件進行更改、添加功能和運行測試，而不會影響其他 button 組件或整個項目。例如，您可以將其代碼更改為如下所示：
// components/button/Button.js
import React from 'react';
const Button = ({ label }) => {
return <button>{label}</button>;
};
export default Button;開發人員可以迭代地優化和改進組件，編寫特定于button組件的測試和文檔。Bit 使開發人員能夠專注于各個組件及其功能，同時保持清晰的分離和模塊化。
共享和重用組件
Bit 的強大方面之一是能夠跨不同的項目或存儲庫共享和重用組件。開發人員可以使用以下命令將組件發布到共享 button 組件庫：
bit export components/button（當然，您必須首先運行才能對 bit tag 組件進行版本控制）。
此命令發布button組件，使其可供其他開發人員導入并在自己的項目中使用。
這有效地將單個組件的代碼推送到外部存儲庫（來自 Bit）中，這在理論上打破了整個monorepo概念。但是，作為開發人員，這對您來說是完全透明的，這是最好的部分。
其他開發人員可以通過簡單的導入語句安裝和使用該 button 組件：
import Button from '@my-company/button';盡管在傳統的 monorepo 結構中沒有所有組件，但開發人員可以無縫地導入和使用組件，就好像它們是 monorepo 的一部分一樣。Bit負責管理依賴關系并確保版本一致性，為開發人員提供類似monorepo的體驗。
增強的代碼模塊化
使用 Bit的CDD方法，您可以將monorepo分解為單獨的獨立組件。這些組件封裝了特定的功能或 UI 元素，從而實現了更加模塊化的代碼庫。通過促進代碼模塊化，Bit幫助開發人員創建可重用的組件，這些組件可以在monorepo中的不同項目之間輕松共享和集成。
隔離和獨立開發
Bit 使開發人員能夠獨立處理組件。每個組件都可以有自己的開發環境，從而更容易專注于特定的特性或功能。這種隔離降低了意外副作用的風險，并使測試和調試更加高效。借助 Bit，您可以獨立開發、測試和迭代組件，從而加快開發過程并提高代碼質量。
無縫協作
Bit 通過提供用于共享和重用組件的集中式中心（Bit.cloud），簡化了處理 monorepo 的開發人員之間的協作。使用 Bit的CDD，開發人員可以將組件發布到共享組件庫或Bit 注冊表。這使其他開發人員可以輕松地在自己的項目中發現、導入和使用這些組件。Bit的內置版本控制確保組件可以在monorepo之間更新和共享而不會發生沖突。了解更多信息。
高效的文檔和測試
Bit的CDD方法鼓勵開發人員將組件作為單獨的實體進行文檔和測試。文檔和測試與每個組件緊密集成，使開發人員更容易理解其用途、API 和用法。Bit 允許您獨立生成文檔并為每個組件運行測試，從而確保代碼庫的質量和可靠性。這種以文檔為中心的方法提高了代碼的可維護性，并促進了開發團隊內的知識共享。如果您想了解有關為 Bit 組件編寫文檔的更多信息，請查看其文檔中的此頁面。
事實上，如果你看一下 Bit.cloud 上的組件，你會得到這樣的東西。
圖片
在那里，您可以獲得很多信息，例如有關組件的基本統計信息，以及您可以修改的實時代碼示例。它還具有渲染 Markdown 的能力，因此您可以使用它解釋所需的一切。
粒度版本控制和依賴項管理
Bit 支持對 monorepo 中的組件進行精細版本控制。每個組件都可以有自己的版本，從而可以精確控制更新和依賴項。Bit 自動處理組件依賴項的解析，確?？珥椖渴褂谜_的版本。這消除了版本沖突并簡化了 monorepo 中的依賴項管理。
要了解更多信息，請閱讀本文[https://bit.dev/blog/painless-monorepo-dependency-management-with-bit-l4f9fzyw/]。
或者，您可以查看此視頻：https://youtu.be/Z2kPUlLynzU
總之，Bit解決了monorepos帶來的所有問題，并增加了一些其他好處。正如您所看到的，上面的列表涵蓋了monorepo方法可能具有的所有“但是”。
請記住，對于Bit，您只會認為您正在處理Monorepo，但是在幕后，您并非如此。
如果您考慮將 Bit 添加到現有和已建立的單存儲庫中的場景，這將特別有趣。您將使用 Bit 單獨提取每個組件，記錄它們，對它們進行版本控制并在 Bit.cloud 的幫助下共享它們。有效地將單存儲庫分解為單個組件大小的存儲庫。但所有這些都會發生，你甚至不關心它。
寫在最后
使用正確的工具集，管理 monorepos 變得更加易于管理和愉快。Bit的組件驅動開發（CDD）方法將代碼庫分解為可重用的組件，促進模塊化，獨立開發，協作和高效的依賴關系管理。
Turborepo 提供性能優化，如并行構建和增量測試，簡化大規模項目開發。RushJS為單存儲庫管理提供了一個全面的工具包，確保一致的項目結構，版本兼容性和高效的依賴關系處理。借助這些工具，開發人員可以有效地應對monorepo挑戰，從而提高生產力和代碼質量。
通過利用Bit，Turborepo或RushJS，您也可以簡化工作流程。無論是Bit以組件為中心的方法，Turborepo的性能優化，還是RushJS的綜合工具包，每個工具都帶來了獨特的功能和優勢。
采用這些工具，嘗試工作流程，并為您的團隊找到正確的方法。Monorepo 管理不一定是一種痛苦——它可以是一種有益的體驗，可以促進協作、代碼重用和高效開發。
享受編碼，愿您的monorepo之旅取得成功！
