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 命令行操作步骤

确认要撤销的提交哈希
bash 复制代码
```
git log --oneline
```
假设你的两次提交分别为 A（旧）和 B（新），别人的提交位于他们之后。
按从新到旧的顺序执行 revert（先 B 后 A，可最大程度减少冲突）
bash 复制代码
```
git revert <B的哈希>
git revert <A的哈希>
```
- 每次执行会弹出编辑器让你确认提交信息，可直接保存退出。
- 如果出现冲突，解决后执行 git add . 和 git revert --continue。
推送到远程
bash 复制代码
```
git push 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 提交：
bash 复制代码
```
git log --oneline -3
```
启动交互式变基：
bash 复制代码
```
git rebase -i HEAD~2
```
在编辑器中，将两个提交前面的 pick 改为 reword（或简写 r），保存退出。
Git 会依次打开每个提交的注释编辑框，无需修改内容，直接保存退出 。此时已安装的 commit-msg 钩子会自动在末尾插入 Change-Id。
变基完成后，检查提交信息：
bash 复制代码
```
git log --format=full
```
重新推送：
bash 复制代码
```
git push 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 revert vs git 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）。

通过以上工作流，你可以安全、合规地在 Gerrit 管理的共享分支上撤销自己的多次提交，且整个团队的协作不受任何影响。

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