Repo、Manifest与Gerrit：如何协同构建高效开发流程？

1. 从“单打独斗”到“集团军作战”：为什么我们需要Repo、Manifest和Gerrit？

如果你只维护一个Git仓库，那生活是相当简单的。git clone、git commit、git push，一套组合拳下来，代码就提交了。但想象一下，你加入了一个像安卓（AOSP）这样规模的项目，它由成百上千个独立的Git仓库组成，每个仓库负责不同的模块，比如内核、框架、应用、驱动等等。这时候，你面临的第一个问题就是：我怎么把这几百个仓库都下载到本地？难道要手动执行几百次 git clone 吗？这显然不现实。更麻烦的是，这些仓库之间往往有依赖关系，你需要确保下载的是相互兼容的版本，否则代码根本编译不过。

这就是Repo工具诞生的背景。Repo本身不是一个全新的版本控制系统，它本质上是一个用Python写的脚本集合，是站在巨人（Git）肩膀上的“指挥官”。它的核心任务就是帮你管理多个Git仓库。你可以把它想象成一个项目的“总管家”，你只需要告诉它一个清单（Manifest），它就能帮你把清单上列出的所有仓库，按照指定的分支和路径，一次性、有条不紊地克隆到你的工作目录中。之后，无论是更新所有仓库到最新，还是切换到某个特定的历史快照，都只需要一条简单的 repo sync 命令。这极大地简化了大型项目的环境搭建和日常维护。

那么，这个至关重要的“清单”是什么呢？它就是Manifest文件，一个XML格式的配置文件。这个文件里定义了所有需要管理的Git仓库的详细信息：仓库的远程地址（URL）、在本地工作区中的相对路径、应该跟踪哪个分支，甚至可以为不同的仓库指定不同的代码评审服务器。Manifest文件本身也是一个Git仓库，这意味着你可以像管理代码一样管理这个清单。当项目需要引入一个新模块，或者某个模块的仓库地址发生变化时，只需要更新这个Manifest仓库，所有开发者下次执行 repo sync 时，他们的本地环境就会自动与新的清单保持一致。这保证了团队中每个人所使用的代码库版本和结构都是统一的，从源头上避免了“你那里能编译，我这里报错”的经典问题。

当代码下载、修改完毕，准备提交时，另一个挑战出现了：如何确保提交到这几百个仓库的代码变更都是高质量的，并且能被其他开发者有效评审？直接把代码 push 到中央仓库的 main 分支是危险且粗鲁的，这可能会破坏主线代码的稳定性。这时候，Gerrit就该登场了。Gerrit是一个基于Web的代码评审和项目管理工具。它充当了代码进入主仓库之前的“守门人”。当你使用 repo upload 命令提交代码时，你的变更并不会直接合并，而是会生成一个“变更集”（Change），上传到Gerrit服务器上。这个变更集就像一个待办事项，其他团队成员可以在网页上直观地看到你改了哪些文件，逐行添加评论，进行讨论，甚至运行自动化测试。只有经过足够数量的评审员同意（比如打上+2的分数），这个变更才能被正式合并到目标分支中。

所以，这三者形成了一个完美的闭环工作流：Repo 负责把海量代码仓库“搬”到你的本地；Manifest 是告诉Repo“搬什么、搬到哪里、搬哪个版本”的精确图纸；而 Gerrit 则是在代码“入住”中央仓库前，进行严格“质量验收”的关卡。它们协同工作，将大型项目混乱的多仓库管理和代码协作，变得井然有序、高效可控。接下来，我们就深入看看每个工具具体怎么用，以及如何把它们串联起来。

2. 上手第一步：配置Repo与理解Manifest

2.1 安装与初始化Repo

Repo本身是一个脚本工具，安装非常简单。因为它是一个Python脚本，所以首先确保你的系统已经安装了Python（通常是2.7或3.x版本）。然后，只需要下载Repo启动器并放到你的系统路径里。

# 创建一个用于存放Repo工具的目录，并加入PATH
mkdir -p ~/.bin
export PATH=~/.bin:$PATH

# 下载Repo脚本
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
chmod a+x ~/.bin/repo

现在，你就可以在终端里使用 repo 命令了。假设你要参与一个名为“SuperProject”的大型项目，这个项目的代码分散在几十个Git仓库里。项目组会提供一个Manifest仓库的地址。初始化工作区的命令格式如下：

# 创建一个新的工作目录
mkdir superproject-workspace && cd superproject-workspace

# 使用repo init初始化，-u 指定Manifest仓库的URL，-b 指定Manifest仓库的分支
repo init -u https://your-company.com/platform/manifest.git -b main

执行这条命令后，会发生几件事：

1. Repo会在当前目录（superproje