版本管理

# 40.版本管理

本文我们来介绍下 Git 管理版本的几个常用命令。请读者务必也动手实践。

‍

# git log：查看提交日志

随着对文件的不断修改与提交，Git 帮我们管理了之前的各个版本。就好比玩一个能存档的游戏，每过一关就能帮我们存档，如果某一关没打过，就可以从上一个存档开始（而不用从头开始）。

Git 也可以帮助我们回退到上一个版本，甚至更早之前的版本。这在我们搞错了代码，需要回退的时候非常有用。

我们先看看我们目前有几个版本的文件：

版本 1：wrote a readme file

Git is a version control system
Git is free software.

1
2

版本 2：add distributed word

Git is a distributed version control system
Git is free software.

1
2

版本 3：append GPL word

Git is a distributed version control system
Git is free software distributed under the GPL.

1
2

‍ 目前版本比较少，我们还能清晰的记得；但如果改动了数十次，或者过去了数十天，肯定是不记得有多少版本的（这也是我们为什么需要版本控制工具）。 ‍ 我们可以通过 git log 命令查看我们提交的记录：

commit efc913812101fe78072d04fcaa1fbdbdf6e5819b (HEAD -> master)
Author: peterjxl <peterjxl@qq.com>
Date:   Thu Jan 12 07:59:55 2023 +0800

    append GPL word

commit 750360e56f221a24062869439d7884660670305f
Author: peterjxl <peterjxl@qq.com>
Date:   Thu Jan 12 07:49:37 2023 +0800

    add distributed word

commit 0282c44552525822a4e6ffd705dd35da243e1c7a
Author: peterjxl <peterjxl@qq.com>
Date:   Thu Jan 12 07:32:04 2023 +0800

    wrote a readme file

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

我们来简单解读下输出

第一行是 commit 的 ID，每次 commit 都会有一个唯一的 ID，叫做 commit id。这是一个通过算法计算出来的值，并且每个人不一样（读者自己实践的结果肯定和我的结果不一致，后续不再说明）
第二行是提交者，即姓名和邮箱
第三行是提交的时间
接下来是提交的说明，就是我们之前 git commit -m 后面跟的参数

当我们输入 git log 的时候，相当于用 vim 打开了一个日志文件，要退出请输入 q 后回车。

git log 命令显示从最近到最远的提交日志，我们可以看最近的 3 次提交，最近的一次是 append GPL word，上一次是 add distributed word，再上一次是 wrote a readme file。

如果嫌输出信息太多，看得眼花缭乱的，可以试试加上 --pretty=oneline 参数，就会简化为一行：

$ git log --pretty=oneline
efc913812101fe78072d04fcaa1fbdbdf6e5819b (HEAD -> master) append GPL word
750360e56f221a24062869439d7884660670305f add distributed word
0282c44552525822a4e6ffd705dd35da243e1c7a wrote a readme file
0b3cfefd49148371adf4fa6da02192685ff03788 add world.txt and diff.txt
abf2051bd989d0b129066bff3700a019665469ce add diff and patch hello.txt

1
2
3
4
5
6

‍ 直接使用 git log --oneline，这样 commit id 更短：

$ git log --oneline
efc9138 append GPL word
750360e add distributed word
0282c44 wrote a readme file
0b3cfef add world.txt and diff.txt
abf2051 add diff and patch hello.txt

1
2
3
4
5
6

每提交一个新版本，实际上 Git 就会把它们自动串成一条时间线。如果使用可视化工具查看 Git 历史，就可以更清楚地看到提交历史的时间线。以 GitExtensions 为例：

（这里仅仅是演示，后续我们讲怎么使用 GitExtensions） ‍ 还可以指定多少条 commit：

$ git log -2

数字 2 表示只显示最近两条，可自行修改数字 ‍

# git reset：回退版本

现在我们想要回退到上一版本，怎么办呢？首先，Git 用 HEAD 表示当前版本，用一个 ^ 表示上一个版本，也就是 HEAD^ 表示上一个版本。上两个版本就是 HEAD^^，如果要回退的版本比较多，可以用数字，例如 HEAD^114 表示前 114 个版本。

我们可以使用 git reset 命令来回退版本：

> git reset --hard HEAD^
HEAD is now at 750360e add distributed word

1
2

--hard 参数后面会讲是什么意思。Git 告诉我们当前版本是指向了 750360e add distributed word ‍ 然后我们看看文件内容：

> cat readme.txt
Git is a distributed version control system
Git is free software

1
2
3

可以看到文件确实被还原到上一个版本了，少了 GPL。此时如果我们用 git log 查看提交日志：

> git log
commit 750360e56f221a24062869439d7884660670305f (HEAD -> master)
Author: peterjxl <peterjxl@qq.com>
Date:   Thu Jan 12 07:49:37 2023 +0800

    add distributed word

commit 0282c44552525822a4e6ffd705dd35da243e1c7a
Author: peterjxl <peterjxl@qq.com>
Date:   Thu Jan 12 07:32:04 2023 +0800

    wrote a readme file

1
2
3
4
5
6
7
8
9
10
11
12

append GPL word 的那个版本不见了！那是不是完全丢失了呢？办法还是有的，还记得我们前面查看过的 git log 吗：

$ git log --pretty=oneline
efc913812101fe78072d04fcaa1fbdbdf6e5819b (HEAD -> master) append GPL word
750360e56f221a24062869439d7884660670305f add distributed word
0282c44552525822a4e6ffd705dd35da243e1c7a wrote a readme file
0b3cfefd49148371adf4fa6da02192685ff03788 add world.txt and diff.txt
abf2051bd989d0b129066bff3700a019665469ce add diff and patch hello.txt

1
2
3
4
5
6

通过 append GPL word 这个版本的 commit id，我们就可以回到这个版本：

> git reset --hard efc9
HEAD is now at efc9138 append GPL word

1
2

commit id 不一定要写全，写几个就行；但是如果你只写一两位，那么可能会找到多个 commit id，Git 就不知道你是指定什么版本了。 ‍ 我们再看看文件内容：

> cat readme.txt
Git is a distributed version control system
Git is free software distributed under the GPL.

1
2
3

文件又回来了！舒了一口气。

# head 与时间线

前面我们说过，每提交一个新版本，Git 就会把它们自动串成一条时间线，有点像数据结构中的链表：

wrote a readme file ->add distributed word -> append GPL word

或者画成下面这样：

        ○ append GPL word
        │
        ○ add distributed word
        │
        ○ wrote a readme file

1
2
3
4
5

‍ 而 head，就相当于一个指针，指向当前的版本：

┌────┐
│HEAD│
└────┘
   │
   └──▶ ○ append GPL word
         │
         ○ add distributed word
         │
         ○ wrote a readme file

1
2
3
4
5
6
7
8
9

我们之前说的回退版本，其实就是移动下指针，然后把工作区的文件更新到该版本：

┌────┐
│HEAD│
└────┘
   │
   │     ○ append GPL word
   │     │
   └──▶ ○ add distributed word
         │
         ○ wrote a readme file

1
2
3
4
5
6
7
8
9

‍

# git reflog：记录输入的命令

如果你回退版本后，不幸关掉了命令行窗口，忘记了某个版本的 commit id，要怎么办呢？

可以用 git reflog 命令，可以查看对版本的操作记录，包括被操作版本的版本号。

简单的说，该命令记录了你输入的每一次命令（并且会贴心的告诉你 commit id）：

> git reflog
efc9138 (HEAD -> master) HEAD@{0}: reset: moving to efc9
750360e HEAD@{1}: reset: moving to HEAD^
efc9138 (HEAD -> master) HEAD@{2}: commit: append GPL word
750360e HEAD@{3}: commit: add distributed word
0282c44 HEAD@{4}: commit: wrote a readme file
0b3cfef HEAD@{5}: commit: add world.txt and diff.txt
abf2051 HEAD@{6}: commit (initial): add diff and patch hello.txt

1
2
3
4
5
6
7
8

从这里我们可以看到，append GPL word 这个版本的 commit id 是 efc9138，这下彻底放心啦~✌

# git revert

刚刚我们介绍的 git reset 命令，其实就是移动了下 head 指针，移动之后，append GPL word 版本就相当于丢失了（好比一个没有地址指向的链表结点）

┌────┐
│HEAD│
└────┘
   │
   │     ○ append GPL word
   │     │
   └──▶ ○ add distributed word
         │
         ○ wrote a readme file

1
2
3
4
5
6
7
8
9

并且，其他人是难以找到这个版本的。另外一种回退到指定版本的方式是使用 git revert，其和 git reset 的区别如下（引自廖雪峰老师的解答）：

如果已经有 A -> B -> C，想回退到 B：

方法一：reset 到 B，但会丢失 C：A -> B

方法二：再提交一个 revert 反向修改，变成 B： A -> B -> C -> B，这样 C 还在，但是两个 B 是重复的

看自己想要什么效果，也许 C 就是瞎提交错了（比如把敏感信息提交上去了），必须 reset，不能让别人找到；

如果 C 就是修改，现在又要改回来，将来可能再改成 C，那可以用 revert，这样两个版本都会保留； ‍ 相关用法：

$ git revert HEAD                撤销前一次 commit
$ git revert HEAD^               撤销前前一次 commit  
$ git revert commit_id

1
2
3

‍

# 关于 commit 的 msg

git commit 是很小的一件事情，但是往往小的事情往往引不起大家的关注，如果你查看 commit log，都只有简单的几个词的描述的话，是完全不知道这些 commit 是要做啥的，推荐阅读：Git 最佳实践：commit msg (opens new window)。

即使我们有了 Commit Message 规范，但仍然可能会遇到提交的 Commit Message 不符合规范的情况，这个时候就需要我们能够修改之前某次 commit 的 Commit Message。

具体来说，我们有两种修改方法，分别对应两种不同情况：

git commit --amend：修改最近一次 commit 的 message；
git rebase -i：修改某次 commit 的 message。

# 小结

本文我们介绍了如下命令：

git log 查看提交日志 --pretty=oneline 简化为一行，-n 指定显示多少个
git reflog: 记录输入的日志
git reset --hard HEAD^ 回退版本
git revert：回退版本的另一种方式

上次更新: 2025/5/5 17:15:09

← 初识版本库工作区、暂存区和修改→