1~
2Khi làm việc trên các dự án phần mềm phức tạp, sự lựa chọn giữa monorepo và polyrepo có thể ảnh hưởng đáng kể đến năng suất của nhóm và khả năng mở rộng mã nguồn. Trong bài viết này, chúng tôi phân tích sự khác biệt, ưu và nhược điểm của từng cách tiếp cận, và giúp bạn hiểu đâu là lựa chọn phù hợp.
3~
4## Monorepo và Polyrepo là gì?
5~
6### Monorepo
7~
8Một **monorepo** (kho lưu trữ đơn) là một kho lưu trữ duy nhất chứa mã nguồn của nhiều dự án, dịch vụ hoặc gói, thường liên quan đến nhau.
9~
10```plaintext filename="Example Monorepo Structure"
11my-monorepo/
12  packages/
13    frontend/
14    backend/
15    shared/
16  package.json
17  turbo.json
18```
19~
20### Polyrepo
21~
22Một **polyrepo** (nhiều kho lưu trữ) có nghĩa là mỗi dự án, dịch vụ hoặc gói có kho lưu trữ riêng biệt.
23~
24```plaintext filename="Example Polyrepo Structure"
25repos/
26  frontend/
27    package.json
28  backend/
29    package.json
30  shared/
31    package.json
32```
33~
34## Sự khác biệt trực quan
35~
36```mermaid
37flowchart TD
38    subgraph Monorepo
39        A1["frontend/"]
40        A2["backend/"]
41        A3["shared/"]
42    end
43    style Monorepo fill:#e0e7ff,stroke:#6366f1,stroke-width:2px
44```
45~
46```mermaid
47flowchart TD
48    subgraph Polyrepo
49        B1["frontend repo"]
50        B2["backend repo"]
51        B3["shared repo"]
52    end
53    style Polyrepo fill:#fee2e2,stroke:#ef4444,stroke-width:2px
54```
55~
56## Ưu và nhược điểm
57~
58### Monorepo
59~
60**Ưu điểm:**
61- Dễ dàng chia sẻ mã nguồn hơn (ví dụ: thư viện dùng chung).
62- Tái cấu trúc nguyên tử trên nhiều dự án.
63- Quản lý tập trung các phụ thuộc và cấu hình.
64~
65**Nhược điểm:**
66- Có thể trở nên nặng khi codebase phát triển.
67- Cần công cụ để quản lý build/test từng phần (ví dụ: Nx, Turborepo).
68~
69### Polyrepo
70~
71**Ưu điểm:**
72- Mỗi nhóm/dự án đều độc lập.
73- Dễ quản lý hơn cho các dự án nhỏ.
74- Cho phép chính sách truy cập chi tiết.
75~
76**Nhược điểm:**
77- Khó chia sẻ mã nguồn mà không xuất bản gói.
78- Tái cấu trúc xuyên kho lưu trữ phức tạp hơn.
79- Có thể trùng lặp cấu hình.
80~
81## Ví dụ thực tế: Monorepo với Turborepo
82~
83Giả sử bạn muốn tạo một monorepo với frontend và backend sử dụng Turborepo.
84~
85### 1. Khởi tạo monorepo
86~
87```bash
88npx create-turbo@latest
89```
90~
91### 2. Cấu trúc điển hình
92~
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # shared component library
100    utils/      # shared functions
101  turbo.json
102  package.json
103```
104~
105### 3. Ví dụ workspace trong `package.json`
106~
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116~
117### 4. Ví dụ import thư viện dùng chung
118~
119Giả sử bạn có một hàm trong `packages/utils/src/formatDate.ts`:
120~
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('en-US');
125}
126```
127~
128Trong frontend:
129~
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133~
134export default function Home() {
135  return <div>Today is {formatDate(new Date())}</div>;
136}
137```
138~
139## Khi nào nên chọn Monorepo?
140~
141- Nhóm vừa và lớn làm việc trên nhiều dự án liên quan.
142- Cần chia sẻ mã nguồn và thực hiện tái cấu trúc quy mô lớn.
143- Dự án phát triển nhanh và cần build/test tối ưu.
144~
145## Khi nào nên chọn Polyrepo?
146~
147- Dự án nhỏ hoặc độc lập.
148- Các nhóm riêng biệt làm việc trên các sản phẩm khác nhau.
149- Chính sách truy cập rất hạn chế.
150~
151## Kết luận
152~
153Không có giải pháp hoàn hảo cho tất cả mọi người. Sự lựa chọn phụ thuộc vào quy mô nhóm, độ phức tạp của dự án và nhu cầu hợp tác. Điều quan trọng là nhận thức được các đánh đổi và chọn đúng công cụ để quản lý độ phức tạp.
154~