当前位置：首页 > news >正文

Git 共享分支安全撤销提交与 Gerrit Change-Id 问题处理指南

news 2026/6/4 22:32:26

Git 共享分支安全撤销提交与 Gerrit Change-Id 问题处理指南

一、背景与目标

在多人协作的分支上，你先后提交了两次代码修改（提交 A 和 B），之后有其他同事提交了新的代码（提交 C、D）。此时你需要将自己那两次修改完整撤销，但不能影响或改写任何其他人的提交。同时，团队使用 Gerrit 进行代码审查，每个推送的提交必须携带有效的Change-Id。

本文将汇总解决这一问题的标准工作流、常见错误及多种操作方式（命令行与 IntelliJ IDEA），并给出简化实践。

注：

博客：

https://blog.csdn.net/badao_liumang_qizhi

二、使用`git revert`安全撤销提交

git revert会创建一个反向提交，其内容正好抵消指定提交引入的所有修改。因为历史中只新增提交而不改写已有提交，所以完全不会影响他人工作，是共享分支上撤销的最安全方式。

2.1 命令行操作步骤

确认要撤销的提交哈希
```
gitlog--oneline
```
假设你的两次提交分别为A（旧）和B（新），别人的提交位于他们之后。
按从新到旧的顺序执行 revert（先 B 后 A，可最大程度减少冲突）
```
gitrevert<B的哈希>gitrevert<A的哈希>
```
- 每次执行会弹出编辑器让你确认提交信息，可直接保存退出。
- 如果出现冲突，解决后执行git add .和git revert --continue。
推送到远程
```
gitpush origin<你的分支名>
```

执行后历史变为：

Revert "A" <-- 新增 Revert "B" <-- 新增 D <-- 别人的提交，不受影响 C B A ...

2.2 IntelliJ IDEA 图形化操作

打开Git→Log面板。
先找到较新的提交B，右键选择Revert Commit，点击Revert，确认后Commit。
再找到较旧的提交A，同样右键 →Revert Commit→Revert→Commit。
点击工具栏Push（绿色箭头）推送到远程。

注意事项：不要使用Reset Current Branch或Interactively Rebase from Here删除提交，这些会改写历史，需要强制推送，影响他人工作。

三、推送到 Gerrit 时出现`missing Change-Id`错误

当你把上面生成的两个 Revert 提交 push 到 Gerrit 时，可能遇到如下错误：

remote: ERROR: commit 9773324: missing Change-Id in message footer remote: Hint: to automatically insert a Change-Id, install the hook: remote: gitdir=$(git rev-parse --git-dir); scp xxx gitdir}/hooks/ remote: and then amend the commit: remote: git commit --amend --no-edit remote: Finally, push your changes again

3.1 错误原因

Gerrit 要求每个提交的注释末尾都包含一个Change-Id: I...，用于关联评审记录。本地仓库未安装 Gerrit 提供的commit-msg钩子，因此git revert生成的新提交里没有自动添加该字段。

四、为已有的两个 Revert 提交补全 Change-Id

因为缺少 Change-Id 的 Revert 提交尚在本地（推送被拒），可以安全地改写它们以补充该字段。以下提供命令行与 IDEA 两种方法。

4.1 命令行方法：交互式变基 (reword)

确认最近两个提交是自己的 Revert 提交：
```
gitlog--oneline-3
```
启动交互式变基：
```
gitrebase-iHEAD~2
```
在编辑器中，将两个提交前面的pick改为reword（或简写r），保存退出。
Git 会依次打开每个提交的注释编辑框，无需修改内容，直接保存退出。此时已安装的commit-msg钩子会自动在末尾插入Change-Id。
变基完成后，检查提交信息：
```
gitlog--format=full
```
重新推送：
```
gitpush origin HEAD:refs/for/master
```

4.2 IntelliJ IDEA 方法：交互式变基

前提：已在 IDEA 的 Terminal 中完成钩子安装（命令同上）。

打开Git→Log。
找到较旧的那个 Revert 提交，右键选择Interactively Rebase from Here。
在弹出的窗口中，将你自己的两个 Revert 提交对应的Action从Pick改为Reword（中文版“重写提交信息”）。别人的提交保持 Pick 不变。
点击Start Rebasing。
IDEA 会依次弹出提交信息编辑框，不要做任何修改，直接点击Resume（或 Continue）。钩子会在后台自动添加 Change-Id。
变基完成后，可在 Log 中看到提交哈希变化，且提交信息末尾已包含Change-Id。
点击Push，推送到refs/for/master。

五、简化实践：合并 Revert 提交并统一生成 Change-Id

你也可以将两个 Revert 提交合并为一个新提交，直接推送一个“整合撤销”到 Gerrit，使历史更简洁。操作逻辑如下：

执行两次 revert：在 Log 中分别右键你的原始提交 A 和 B，选择Revert Commit，本地生成两个 Revert 提交。
合并这两个 Revert 提交：
- 在 Log 中选中这两个连续的 Revert 提交，右键选择Squash Commits（或使用交互式变基将其设为squash）。
编辑提交信息：IDEA 会弹出合并后的提交信息编辑器，此时 Gerrit 插件会自动生成含Change-Id的模板（若未生成，请确保钩子已安装，或手动在末尾添加Change-Id: I...）。
完成提交并推送：点击 Commit，然后 Push 到refs/for/master。

这种方式的结果是：只新增了一个你自己的提交，它撤销了两次原始修改，且不受他人提交影响，完全符合 Gerrit 要求。

注意：上述操作的前提是那两个 Revert 提交尚未推送成功（你的情况正是推送被拒），改写是安全的。

如果两个Revert已经被提交，可以IDEA中右键两次提交选择Undo Commit，然后将两次的Revert 的Commit在本地使用Gerrit插件等方式生成一次新的提交信息，然后再统一提交和推送。

六、关键知识点与注意事项

git revertvsgit reset/git rebase -i
在共享分支上，永远使用revert新增反向提交，不要改写已推送的历史，否则需要--force推送，会导致其他人的本地历史混乱。
Revert 顺序
先 revert 较新的提交，再 revert 较旧的提交，可有效减少冲突。因为后提交的可能依赖于先提交的内容，逆序撤销更符合代码演进逻辑。
Change-Id 机制
Gerrit 使用Change-Id来唯一标识一个评审。确保commit-msg钩子已正确安装至每个参与开发的本地仓库，否则任何通过git commit、git revert、rebase等生成的新提交都可能缺失该字段。
钩子安装位置
钩子存放在仓库本地的.git/hooks/目录下，不会被推送。新克隆的仓库需要重新安装。
IDEA 与 Gerrit 插件
若安装了 Gerrit 插件，合并提交时可能自动生成 Change-Id，但仍建议安装原生钩子作为可靠兜底。
冲突处理
无论是 revert 还是 rebase 过程，都可能出现冲突。始终保持冷静，手动解决冲突后通过git add标记已解决，再继续操作（git revert --continue或git rebase --continue）。