Git 代码回滚与找回的艺术

本文作者： marklai （赖泽浩）- 高级软件工程师，十年软件配置管理经验，现服务于 CSIG 云与智慧产业事业群质量部

导语

Git 是一个灵活和强大的版本管理工具，正确使用能够有效促进团队协作，防止版本丢失。然而实践中，有些开发人员会或有意或无意地误用部分 Git 的功能，给团队带来困扰，甚至造成损失。不恰当的代码回滚操作是其中的主要问题之一。

本文主要分享针对不同场景的代码回滚操作，以及如何抢救误删的内容。

一个典型案例

我们先通过一个项目团队真实出现过的典型案例，来看看不恰当的代码回滚可能带来的问题。

（ 1 ）小红、小黄、小蓝共同工作在同一条分支上。

（ 2 ）小红利用reset回滚了一些内容，发现 push 失败，最后用 push -f 操作成功。 更甚者，push -f提示目标是保护分支（例如master）而无法推送成功，于是小红取消了分支保护，从而使得push -f成功。

（ 3 ）小黄小蓝进行常规 git pull，遇到了一大堆冲突，并且 commit 历史都乱了！

（ 4 ）过一段时间，需要查看某次发布的源代码，却发现无法找到准确的代码！原来它刚好被小红之前reset掉了。

认识 Git 的四个工作区域

在盘点常见的代码回滚场景之前，有必要认识一下 Git 的四个工作区域。

平常我们 clone 一个代码库之后，本地看起来就是一个包含所有项目文件的目录。其实从逻辑上可以分为四个工作区域：

• 工作区 也称工作目录、工作副本，简单来说就是 clone 后我们看到的包含项目文件的目录。我们日常开发操作也是在工作区中进行的。

• 本地仓库（.git ） 在工作区中有个隐藏目录.git，这就是 Git 本地仓库的数据库。工作区中的项目文件实际上就是从这里签出（ checkout ）而得到的，修改后的内容最终提交后记录到本地仓库中。 Tips：不要手动修改 .git 目录的内容

• 暂存区 也称缓存区，逻辑上处于工作区和本地仓库之间，主要作用是标记修改内容，暂存区里的内容默认将在下一次提交时记录到本地仓库中。

• 远端仓库 团队协作往往需要指定远端仓库（一般是一个，也可以有多个），团队成员通过跟远端仓库交互来实现团队协作。

一个基本的 Git 工作流程如下：

1. 在工作区中修改文件
2. 暂存文件，将文件存放在暂存区
3. 将改动从暂存区提交到本地仓库
4. 从本地仓库推送到远端仓库

常见的代码回滚场景

回滚场景：仅在工作区修改时

当文件在工作区修改，还没有提交到暂存区和本地仓库时，可以用 git checkout -- 文件名 来回滚这部分修改。

不过需要特别留意的是这些改动没有提交到 Git 仓库，Git 无法追踪其历史，一旦回滚就直接丢弃了。

示例： 用 git status 查看，还没提交到暂存区的修改出现在 “Changes not staged for commit:” 部分。

执行以下命令回滚工作区的修改：

git checkout -- build.sh

回滚场景：已添加到暂存区时

即执行过 git add 添加到暂存区，但还没 commit，这时可以用 git reset HEAD 文件名 回滚。 通过git status可以看到相关提示：

执行以下命令回滚暂存区的修改：

git reset HEAD build.sh

回滚后工作区会保留该文件的改动，可重新编辑再提交，或者 git checkout -- 文件名 彻底丢弃修改。

回滚场景：已 commit，但还没有 push 时

即已经提交到本地代码库了，不过还没有 push 到远端。这时候可用 git reset 命令，命令格式为：

git reset <要回滚到的 commit> 或者 git reset --hard <要回滚到的 commit>

需注意的是，提供的是 要回滚到的 commit，该 commit 之后的提交记录会被丢弃。

示例：

git reset 默认会将被丢弃的记录所改动的文件保留在工作区中，以便重新编辑和再提交。加上 --hard 选项则不保留这部分内容，需谨慎使用。

回滚场景：修改本地最近一次 commit

有时 commit 之后发现刚才没改全，想再次修改后仍记录在一个 commit 里。利用 "git reset" 可达到这个目的，不过，Git 还提供了更简便的方法来修改最近一次 commit 。

命令格式如下：

git commit --amend [ -m <commit 说明> ]

如果命令中不加-m <commit 说明> 部分，则 Git 拉起编辑器来输入日志说明。示例：

请注意，"git commit --amend" 只可用于修改本地未 push 的 commit，不要改动已 push 的 commit ！

回滚场景：已 push 到远端时

注意！此时不能用 "git reset"，需要用 "git revert"！ 注意！此时不能用 "git reset"，需要用 "git revert"！ 注意！此时不能用 "git reset"，需要用 "git revert"！

重要事情说三遍！之所以这样强调，是因为 "git reset" 会抹掉历史，用在已经 push 的记录上会带来各种问题；而 "git revert" 用于回滚某次提交的内容，并生成新的提交，不会抹掉历史。

示例：

过程中如果遇到问题（如处理冲突时搞乱了），可用 "git revert --abort" 取消本次回滚行为。

如果要回滚的是一个合并 commit，revert 时要加上"-m <父节点序号>"，指定回滚后以哪个父节点的记录作为主线。合并的 commit 一般有 2 个父节点，按 1 、2 数字排序，对于要回滚“分支合入主干的 commit”，常用"-m 1"，即用主干记录作为主线。 回滚合并 commit 是一个较为复杂的话题，作为一般性建议，应避免回滚合并 commit 。对该话题感兴趣的可进一步了解： https://github.com/git/git/blob/master/Documentation/howto/revert-a-faulty-merge.txt

Reset 与 revert 对比

本节再来讲一个示例，以便大家更好地理解git reset和git revert的差异。

分支初始状态如下：

• 如果执行 git reset B 工作区会指向 B，其后的提交（ C 、D ）被丢弃。

此时如果做一次新提交生成 C1，C1跟 C 、D 没有关联。

• 如果执行 git revert B 回滚了B提交的内容后生成一个新 commit E，原有的历史不会被修改。

找回已删除的内容

虽说 Git 是一款强大的版本管理工具，一般来说，提交到代码库的内容不用担心丢失，然而某些特殊情况下仍免不了要做抢救找回，例如不恰当的 reset 、错删分支等。这就是 git reflog派上用场的时候了。

"git reflog"是恢复本地历史的强力工具，几乎可以恢复所有本地记录，例如被 reset 丢弃掉的 commit 、被删掉的分支等，称得上代码找回的“最后一根救命稻草”。

然而需要注意，并非真正所有记录"git reflog"都能够恢复，有些情况仍然无能为力：

1. 非本地操作的记录 "git reflog"能管理的是本地工作区操作记录，非本地（如其他人或在其他机器上）的记录它就无从知晓了。

2. 未 commit 的内容 例如只在工作区或暂存区被回滚的内容（ git checkout -- 文件 或 git reset HEAD 文件）。

3. 太久远的内容 "git reflog"保留的记录有一定时间限制（默认 90 天），超时的会被自动清理。另外如果主动执行清理命令也会提前清理掉。

Reflog - 恢复到特定 commit

一个典型场景是执行 reset 进行回滚，之后发现回滚错了，要恢复到另一个 commit 的状态。

我们通过git reflog查看 commit 操作历史，找到目标 commit，再通过 reset 恢复到目标 commit 。

通过这个示例我们还可以看到清晰、有意义的 commit log 非常有帮助。假如 commit 日志都是"update"、"fix"这类无明确意义的说明，那么即使有"git reflog"这样的工具，想找回目标内容也是一件艰苦的事。

Reflog - 恢复特定 commit 中的某个文件

场景：执行 reset 进行回滚，之后发现丢弃的 commit 中部分文件是需要的。 解决方法：通过 reflog 找到目标 commit，再通过以下命令恢复目标 commit 中的特定文件。

git checkout <目标 commit> -- <文件>

示例： Reset 回滚到 commit 468213d 之后，发现原先最新状态中（即 commit d57f339 ）的 build.sh 文件还是需要的，于是将该文件版本单独恢复到工作区中。

Reflog - 找回本地误删除的分支

场景：用"git branch -D"删除本地分支，后发现删错了，上面还有未合并内容！ 解决方法：通过 reflog 找到分支被删前的 commit，基于目标 commit 重建分支。

git branch <分支名> <目标 commit>

Reflog 记录中，"to <分支名>"（如 moving from master to dev/pilot-001 ） 到切换到其他分支（如 moving from dev/pilot-001 to master ）之间的 commit 记录就是分支上的改动，从中选择需要的 commit 重建分支。

示例：

找回合流后删除的分支

作为 Git 优秀实践之一，开发分支合流之后即可删掉，以保持代码库整洁，只保留活跃的分支。 一些同学合流后仍保留着分支，主要出于“分支以后可能还用得到”的想法。其实大可不必，已合入主干的内容不必担心丢失，随时可以找回，包括从特定 commit 重建开发分支。并且，实际需要用到旧开发分支的情况真的很少，一般来说，即使功能有 bug，也是基于主干拉出新分支来修复和验证。

假如要重建已合流分支，可通过主干历史找到分支合并记录，进而找到分支节点，基于该 commit 新建分支，例如：

git branch dev/feature-abc 1f85427

关于代码回滚的一些建议

以下是关于特定命令的使用建议：

此外，总体来讲，回滚要谨慎，不要过于依赖回滚功能，避免使用"git push -f"。正如某哲人所说：如果用到"git push -f"，你肯定哪里做错了！