编辑“︁Git单体仓库策略”︁

= Git单体仓库策略 =

== 介绍 ==
'''Git单体仓库策略'''（Monorepo Strategy）是一种将多个项目或模块存储在同一个Git仓库中的版本控制方法。与多仓库（Polyrepo）策略不同，单体仓库将所有相关代码、文档和资源集中管理，形成统一的版本历史。该策略被Google、Facebook等科技巨头广泛采用，尤其适合大型项目或紧密耦合的代码库。

主要特点包括：
* '''统一依赖管理'''：所有子项目共享相同的第三方依赖版本
* '''原子提交'''：跨模块的修改可以在单次提交中完成
* '''全局可见性'''：开发者可以查看整个代码库的关联变更
* '''简化协作'''：减少跨仓库协调的开销

== 工作原理 ==
=== 目录结构示例 ===
典型单体仓库的组织结构如下：

<syntaxhighlight lang="bash">
monorepo/
├── .git/
├── docs/
├── libs/
│   ├── utils/
│   └── core/
├── services/
│   ├── api/
│   └── web/
└── tools/
</syntaxhighlight>

=== 版本控制模型 ===
<mermaid>
gitGraph
    commit
    branch feature/auth
    checkout feature/auth
    commit
    commit
    checkout main
    merge feature/auth
    branch fix/issue-123
    commit
    checkout main
    merge fix/issue-123
</mermaid>

== 实施指南 ==
=== 基础配置 ===
1. 初始化仓库：
<syntaxhighlight lang="bash">
git init monorepo && cd monorepo
mkdir -p {libs,services,tools}
</syntaxhighlight>

2. 添加子项目：
<syntaxhighlight lang="bash">
# 添加核心库
git submodule add https://github.com/example/core.git libs/core

# 或直接包含代码
cp -R /path/to/project services/web
git add services/web
</syntaxhighlight>

=== 分支策略 ===
推荐采用：
* '''主干开发'''（Trunk-Based Development）
* '''功能分支'''（Feature Branches）
* '''发布分支'''（Release Branches）

== 优势与挑战 ==
=== 优势 ===
* '''跨项目重构'''更安全
* 依赖更新只需单次提交
* CI/CD流水线可以全局优化
* 新人更容易理解代码关系

=== 挑战 ===
* 仓库体积增长较快
* 需要更精细的权限控制
* 构建工具需要支持monorepo
* 克隆时间可能较长

数学表示仓库复杂度：
<math>
C = \sum_{i=1}^{n} (m_i \times d_i)
</math>
其中：
* <math>m_i</math> = 模块i的修改频率
* <math>d_i</math> = 模块i的依赖数量

== 实际案例 ==
=== Google的单一仓库 ===
Google使用名为"Piper"的定制版单体仓库系统：
* 约20亿行代码
* 每日约4.5万次提交
* 使用自定义的依赖管理系统

=== Facebook的Mercurial仓库 ===
Facebook采用Mercurial扩展的巨型仓库：
* 包含Android、iOS、Web全平台代码
* 使用Watchman文件监控工具
* 开发了内部构建系统Buck

== 工具支持 ==
常用monorepo管理工具：
{| class="wikitable"
|-
! 工具名称 !! 用途
|-
| '''Lerna''' || JavaScript项目管理
|-
| '''Bazel''' || 多语言构建系统
|-
| '''Nx''' || 智能构建系统
|-
| '''Rush''' || 微软开发的monorepo工具
|}

== 最佳实践 ==
1. '''分层结构'''：按功能/业务域组织目录
2. '''变更隔离'''：使用工具限制修改范围
3. '''依赖管理'''：统一版本声明
4. '''权限控制'''：按目录设置访问权限
5. '''构建优化'''：增量构建和缓存

示例的Git钩子配置（防止直接提交到主干）：
<syntaxhighlight lang="bash">
#!/bin/sh
# .git/hooks/pre-commit

if [[ $(git rev-parse --abbrev-ref HEAD) == "main" ]]; then
    echo "直接提交到主干被禁止，请使用功能分支"
    exit 1
fi
</syntaxhighlight>

== 迁移策略 ==
从多仓库迁移到单体仓库的步骤：
1. 创建新仓库并建立目录结构
2. 使用<code>git subtree</code>或<code>git submodule</code>导入项目
3. 统一构建配置
4. 逐步迁移团队工作流程
5. 设置自动化工具链

== 参见 ==
* [[Git子模块]]
* [[Git子树]]
* [[持续集成]]
* [[依赖管理]]

== 扩展阅读 ==
* 《Software Engineering at Google》
* 《Monorepos: Please Don't》- 反对观点
* 《Scaling Mercurial at Facebook》

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git最佳实践]]