git revert 可能是回滚类命令里最被低估的一个。很多开发者一提到“代码回滚”就条件反射地敲 git reset,直到某天在共享分支上把远程历史搞得一团糟、或者亲手丢掉了几十个提交,才开始认真研究 revert。我见过不止一次因为 reset --hard 加强制推送,导致同事本地代码和远程彻底失联的“事故现场”。
revert 做的事很简单:不动历史,而是生成一个与目标提交完全相反的新提交。它安全、留痕、能上远程、还能被再次撤销,是生产环境回滚和团队协作里最稳妥的选择。这篇文章会从基本原理讲起,覆盖基本用法、冲突处理、merge 提交的特殊姿势、踩坑经验,以及一套可以直接抄的发布失败回滚流程。适合刚接触 Git 的新手,也适合在团队里负责分支维护、发布管理的同学,看完至少能分清“回滚到底该用哪个命令”。
1. revert 到底在干什么:先分清回滚三板斧
1.1 反向补丁式的新提交
Git 记录改动的方式是“快照 + 差异”。每次提交保存的是一份完整快照,但展示给我们看的往往是和上一个版本的 diff。revert 的思路非常直白:它把目标提交的 diff 逐行反转,比如原提交把第 20 行从 A 改成了 B,revert 就把 B 改回 A;如果原提交删了一个文件,revert 就把这个文件恢复回来。
关键点是“生成一个新提交”。执行 git revert <commit-hash> 之后,git log 里会多出一条提交记录,提交信息默认是 Revert "原提交标题",并且正文里注释着 This reverts commit <hash>。历史没有被擦除,而是像档案一样一层层叠加。
这也解释了为什么 revert 适合公共分支。已经推送到远端的分支,是所有协作者共有的资产,在上面用 reset 相当于把墙上已经画好的画涂掉再重画,别人手里的旧版本就会和新历史对不上。而 revert 是在画上再盖一层新画,历史依然连贯,大家拉取最新代码后看到的结果是一致的。
1.2 和 reset、restore 的本质区别
我经常把 Git 回滚类操作分成三个层级:未提交的改动、已提交但没推送的提交、已经推送的公共提交。三个层级对应的命令完全不同。
| 操作 | 机制 | 是否改写历史 | 典型场景 | 对协作者的影响 |
|---|---|---|---|---|
git restore |
把工作区/暂存区的文件恢复成某个版本 | 否 | 本地写乱了、误删文件 | 无 |
git reset |
移动当前分支指针,丢弃后续提交 | 是 | 本地提交写错了、还没推送的分支整理 | 导致远程历史分叉,需要强推 |
git revert |
新增一个反向提交 | 否 | 线上回滚、远程分支撤销错误功能 | 无,同事们正常 pull 即可 |
注意 git reset 还有一个变体:git reset --soft 只移动指针保留改动,--hard 会丢弃所有改动。很多人喜欢用它是因为历史看起来更干净,但“干净”的代价是协作风险。只要提交已经推到了远端,我的原则是:一律 revert,不 reset。
1.3 什么时候别用 revert
revert 不是万能的。遇到下面几种情况,用它反而是添乱:
- 改动还在工作区或者刚
git add,没形成提交。此时应该用git restore或git checkout -- <file>,不要为一个还没固化的修改做反向提交。 - 提交只存在于本地,还没推出去。既然没人看到过,直接用
git reset整理成更干净的历史更合适。 - 只是想把某个历史文件临时拿出来看看,不需要动分支状态
