Gerrit代码审查实战指南：从提交到合并的全流程解析

1. 初识Gerrit：它到底是什么，为什么团队离不开它？

如果你刚接触Gerrit，可能会有点懵：这玩意儿和GitHub、GitLab的Pull Request（PR）有啥区别？不都是代码审查吗？我刚开始用的时候也这么想，但真正在团队里用起来才发现，Gerrit的设计哲学和玩法，完全是另一个路子。简单来说，Gerrit是一个基于Git的代码审查和版本管理工具，但它最核心的特点，是它把“提交”和“合并”这两个动作彻底分开了。在GitHub上，你发起一个PR，这个PR里可能包含了好几次提交（commit），大家对着整个PR讨论。而在Gerrit里，每一次提交（commit）本身就是一个独立的审查单元，这个单元在Gerrit里被称为一个“Change”。

这个设计带来的最大好处就是审查粒度更细，历史更清晰。想象一下，一个功能开发了三天，每天都有几次提交。在Gerrit里，每一天、每一次的修改都可以被独立审查、独立验证。如果其中某一次提交引入了问题，你可以单独打回那一次提交，而不是把三天的努力全部否决。这对于维护一个干净、线性的代码历史（比如追求git log --oneline清晰好看）的团队来说，简直是神器。我经历过那种一个PR里塞了20个commit，改了几十个文件，reviewer看得头昏眼花最后只能草草点“Approve”的情况，在Gerrit的流程下，这种情况会大大改善。

Gerrit的另一个灵魂是它的引用命名空间（refs/for/）。这是你第一次推送代码时就会遇到的“拦路虎”。在普通的Git流程里，你git push origin feature-branch就直接把代码推送到远程分支了。但在Gerrit里，你不能直接推送到真正的分支（比如develop）。你必须推送到一个特殊的引用：refs/for/<branch-name>。这个动作的实质是告诉Gerrit：“嘿，我这里有个新的改动，请为它创建一个Change，并挂到develop分支的审查队列里。” 所以，你的代码并没有真正进入develop分支，而是进入了Gerrit的“审查沙盒”。只有经过审查、验证（CI）并最终被提交（Submit）后，这个改动才会被合并到目标分支。这种机制从根本上保证了未经审查的代码不可能污染主分支。

那么，什么样的团队适合用Gerrit呢？从我十年的经验看，对代码质量有极高要求、开发流程规范严格的中大型团队，尤其是那些涉及底层系统、嵌入式、自动驾驶（就像原始文章里提到的场景）等领域的企业，Gerrit几乎是标配。它和Jenkins等CI工具的集成深度，以及它强制的审查流程，虽然一开始会觉得繁琐，但一旦习惯，它就是代码质量的“守门神”。当然，对于小团队或者追求极致敏捷的初创团队，Gerrit的学习和配置成本可能有点高，需要权衡。

2. 上手第一步：配置环境与拉取代码

万事开头难，用Gerrit的第一步往往不是写代码，而是把环境配通。这里面的坑，我踩过不少。

2.1 配置SSH密钥与Git环境

和大多数Git服务器一样，Gerrit通常使用SSH协议进行认证。第一步就是生成并上传你的SSH公钥。这个步骤很基础，但有个细节很多人会忽略：Gerrit服务器可能运行在非标准端口（比如原始文章里的29418）。你在~/.ssh/config文件里配置一下会方便很多。

# 生成SSH密钥对，如果已有可跳过
ssh-keygen -t rsa -b 4096 -C “your_email@example.com”

# 将公钥内容复制，添加到Gerrit网页端的个人设置 -> SSH Keys中
cat ~/.ssh/id_rsa.pub

# 配置 ~/.ssh/config，针对特定Gerrit服务器
Host gerrit.your-company.com
    HostName gerrit.your-company.com
    Port 29418
    User your_username
    IdentityFile ~/.ssh/id_rsa

配置好后，用 ssh -p 29418 your_username@gerrit.your-company.com 测试一下，如果返回Gerrit的欢迎信息（通常包含你的用户名），就说明连接成功了。这一步失败的话，后面的所有操作都无从谈起。

2.2 使用Repo工具管理多仓库

在大型项目中，代码往往由数十甚至上百个Git仓库组成，比如Android、AOSP项目就是典型例子。这时候，Google开发的repo工具就是你的救命稻草。它本质上是一个用Python写的脚本，用来统一管理多个Git仓库。原始文章里的命令就是一个标准的repo init和repo sync流程。

# 初始化repo客户端，指定清单（manifest）仓库和分支
repo init -u ssh://gerrit.company.com/your_manifest_repo \