在使用 Git 进进程式项目或是其它任何项目的版本控制时,有时候可能会因为一些意外而导致项目发生了不应该出现的变动,这时候要如何利用 Git 来还原呢?在这篇文章中,将会介绍如何用 git checkout、git reset、git revert 这三种指令来分别处理不同的状况。

示范用的项目

之后的内容将会一直使用以下 GitHub 链接的项目来做示范:

各位看官可以用以下指令将它 clone 下来:

git clone https://github.com/magiclen/git-recovery-practice.git

复原还没 add 的变动

将 plain.txt 的第 9 行改成 90,不过 90 放在这行显然不怎么合理,所以我们想复原这个变动,该怎么做呢?

将 plain.txt 第 9 行改成 90

所幸我们还没有运行 git add 指令去「stage」这个变动,只要运行以下指令就可以把目前的项目还原成当前的分支(branch)最新的 commit。

git checkout -f

以 git checkout -f 复原变动

git checkout 指令能够只还原一个或多个「unstaged」(add 之前的状态)的文件,不过不是很常用,用法如下:

git checkout [<commit>] -- <文件1在Git仓库中的路径> <文件2在Git仓库中的路径>

以上指令中,commit 的部份是可选的,如果不填的话就会使用暂存区(index)中的版本,也就是只还原「unstaged」的变动。如果填别的 commit 的话,还原回来的文件可能会与当前的分支最新的 commit 不合,此时的文件会是「staged」状态。

例如:

git checkout master -- plain.txt

如果要还原该层工作目录下的所有「unstaged」的变动,用法如下:

git checkout [<commit>] -- .

复原已经 add 但还没 commit 的变动

这个状况同样可以用 git checkout -f 指令来解决。

以 git checkout -f 复原已 add 的变动

但如果我们想要保留这个变动,只是要让它从「staged」状态变回「unstaged」状态。可以使用以下指令:

git reset

以 git reset 将变动改回 unstaged

git reset 指令能够只将一个或多个文件的状态改从「staged」变回「unstaged」。用法如下:

git reset -- <文件1在Git仓库中的路径> <文件2在Git仓库中的路径>

复原已经 commit 但还没 push 的变动

git reset 指令可以使当前的分支移动到某个 commit,并保留当前的文件为「unstaged」状态。用法如下:

git reset <commit>

以 git reset 移动分支到指定的 commit

下图是在演示 git reset 指令在预设模式(mixed)下,会保留当前的文件变动为「unstaged」状态。

mixed 模式保留 unstaged 的文件变动

如果不小心把分支移动错了,可以使用 git reflog 指令来查看 commit,然后再使用一次 git reset 指令把分支移动到正确的 commit 上。

以 git reflog 查看 commit

git reset 指令加上 --hard 参数,就不会保留当前的文件变动。

以 git reset --hard 移动分支

下图是在演示 git reset 指令在 hard 模式下,不会保留当前的文件变动。

hard 模式不保留文件变动

git reset 指令加上 --soft 参数,会分别保留当前「unstaged」状态和「staged」状态的文件变动。已经 commit 过的变动为「staged」状态。

以 git reset --soft 移动分支

下图是在演示 git reset 指令在 soft 模式下,分别保留当前不同状态的文件变动。

soft 模式分别保留不同状态的变动

除了用 git reset 指令来复原分支外,也还可以用 git checkout 指令跳到某个指定的 commit 上,再用 git branch -f 指令将分支强制移动到这个 commit 的方式来完成复原。

例如要从 commit add 8 复原到 add 5,我们可以先利用 tig 指令工具或是 git log --format='%h %s' 来找到 add 5 的哈希值(长的短的都行)。

以 tig 找到 add 5 的哈希值

如下图,首先用 git branch 指令确认目前的分支是 master,然后用 git checkout <commit> 指令跳到 commit add 5 上,再用 git branch -f master 指令将 master 分支强制移动到这个 commit,最后用 git checkout master 指令回到 master 分支。

以 git checkout 与 git branch -f 复原分支

复原已经 commit 并 push 的变动

虽然我们可以直接用上一个小节的方式来复原分支,并使用 git push -f 指令来强制覆盖远程 Git 仓库上的文件,如果这个项目只有我们自己一个人开发倒还行,但如果是多人开发的话,这样的作法不是很好,容易搞烂其它共同开发者的 Git。故比较好的处理方式是:在已经变动的基础下,再去产生新的 commit 来复原变动。(复原变动所产生的变动也是变动。)

git revert 指令可以反转指定 commit 的变动,并且产生新的 commit。用法如下:

git revert <commit>

假设我们要从 add 8 这个 commit 反转 3 个 commit( add 8、add 7、add 6),指令如下:

git revert HEAD
git revert HEAD~2
git revert HEAD~4

由于每次 git revert 指令都会产生新的 commit,所以 commit 次序会是 HEAD、HEAD~2、HEAD~4(数字加 2)。如果要再多反转 1 个 commit,那就要反转 HEAD~6。

以 git revert 反转多个 commit

如果不想要每次反转就产生一个 commit 出来,可以在使用 git revert 指令时加上 --no-commit 参数,最后再一起 commit 就好(不需要使用 add)。

假设我们要从 add 8 这个 commit 反转 3 个 commit( add 8、add 7、add 6),指令如下:

git revert --no-commit HEAD
git revert --no-commit HEAD~1
git revert --no-commit HEAD~2
git commit

以 --no-commit 反转后一起 commit

git revert 指令其实也有提供一个方便的语法,来一次反转指定范围内所有 commit。用法如下:

git revert <commit_start>..[<commit_end>]

以上的 <commit_start> 本身所指的 commit 不会被反转,实际上会从该 commit 的下一个 commit 开始进行反转。若不设置 <commit_end>,预设是 HEAD。

假设我们要从 add 8 这个 commit 反转 3 个 commit( add 8、add 7、add 6),指令如下:

git revert HEAD~3..

以 HEAD~3.. 一次反转范围内的 commit

同样地,如果不想要每次反转就产生一个 commit 出来,可以在使用 git revert 指令时加上 --no-commit 参数,最后再一起 commit 就好。

git revert --no-commit HEAD~3..
git commit

以 --no-commit 反转范围后一起 commit

如果要反转的 <commit_end> 到 <commit_start>(不包含)之间有合并分支的 commit 存在,就需要分段反转。因为我们必须让 Git 知道在反转合并分支的 commit 时,要往哪个分支走。

假设我们要从 add 8 这个 commit 反转回 add 4 的状态,首先要用 tig 指令工具查看在这段反转路线中,有没有岔路出现。找出合并分支的 commit 的哈希值,以及反转后要走的方向。

以 tig 找出合并分支的 commit

然后输入以下指令:

git revert --no-commit <merge commit>..
git revert --no-commit -m 1 <merge commit>

以上指令的 -m 1,是要让 git revert 指令在反转合并分支的 commit 之后往左边走。如果要往右边,就要改成 -m 2。

以 -m 1 反转合并分支的 commit

如上图,此时的项目已经反转回 add 5 的状态。

然后找出合并分支的 commit 往前至左边路线的第一个 commit 的哈希值,以及 add 4 的 commit 哈希值。

以 tig 找出合并 commit 左边路线的哈希值

以 tig 找出 add 4 的哈希值

继续用 git revert 指令做反转,就可以成功回到 add 4 的状态啦!

以 git revert 回到 add 4 的状态