第二版

2.3 Git 基础 - 查看提交历史

查看提交历史

在你创建了若干次提交之后，或者在你克隆了一个有现有提交历史的仓库之后，你可能希望回顾一下到底发生了什么。最基本和强大的工具就是 git log 命令。

这些示例使用一个名为“simplegit”的非常简单的项目。要获取该项目，请运行：

$ git clone https://github.com/schacon/simplegit-progit

当你在这个项目中运行 git log 时，你应该得到类似以下的输出：

$ git log
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 10:31:28 2008 -0700

    Initial commit

默认情况下，在没有参数的情况下，git log 以逆时间顺序（即最新的提交显示在最前面）列出该仓库中的提交。如你所见，该命令列出了每次提交的 SHA-1 校验和、作者姓名和电子邮件、写入日期以及提交信息。

git log 命令提供了大量不同种类的选项，可以精确地显示你正在寻找的内容。在这里，我们将向你展示一些最常用的选项。

其中一个更有用的选项是 -p 或 --patch，它显示每次提交引入的差异（补丁输出）。你还可以限制显示的日志条目数量，例如使用 -2 只显示最后两个条目。

$ git log -p -2
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

diff --git a/Rakefile b/Rakefile
index a874b73..8f94139 100644
--- a/Rakefile
+++ b/Rakefile
@@ -5,7 +5,7 @@ require 'rake/gempackagetask'
 spec = Gem::Specification.new do |s|
     s.platform  =   Gem::Platform::RUBY
     s.name      =   "simplegit"
-    s.version   =   "0.1.0"
+    s.version   =   "0.1.1"
     s.author    =   "Scott Chacon"
     s.email     =   "schacon@gee-mail.com"
     s.summary   =   "A simple gem for using Git in Ruby code."

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index a0a60ae..47c6340 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -18,8 +18,3 @@ class SimpleGit
     end

 end
-
-if $0 == __FILE__
-  git = SimpleGit.new
-  puts git.show
-end

此选项显示相同的信息，但在每个条目之后直接显示差异。这对于代码审查或快速浏览协作者添加的一系列提交中发生的事情非常有用。你还可以将一系列摘要选项与 git log 一起使用。例如，如果你想查看每个提交的一些简略统计信息，可以使用 --stat 选项：

$ git log --stat
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

 Rakefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

 lib/simplegit.rb | 5 -----
 1 file changed, 5 deletions(-)

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 10:31:28 2008 -0700

    Initial commit

 README           |  6 ++++++
 Rakefile         | 23 +++++++++++++++++++++++
 lib/simplegit.rb | 25 +++++++++++++++++++++++++
 3 files changed, 54 insertions(+)

如你所见，--stat 选项在每个提交条目下方打印一个修改文件列表，以及修改了多少文件，以及这些文件中添加和删除了多少行。它还在末尾放了一个信息摘要。

另一个非常有用的选项是 --pretty。此选项将日志输出更改为除默认格式之外的其他格式。你可以使用几个预设的选项值。此选项的 oneline 值将每个提交打印在一行上，这在查看大量提交时非常有用。此外，short、full 和 fuller 值以大致相同的格式显示输出，但信息量分别更少或更多：

$ git log --pretty=oneline
ca82a6dff817ec66f44342007202690a93763949 Change version number
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 Remove unnecessary test
a11bef06a3f659402fe7563abf99ad00de2209e6 Initial commit

最有趣的选项值是 format，它允许你指定自己的日志输出格式。这在为机器解析生成输出时特别有用——因为你明确指定了格式，所以你知道它不会随 Git 的更新而改变。

$ git log --pretty=format:"%h - %an, %ar : %s"
ca82a6d - Scott Chacon, 6 years ago : Change version number
085bb3b - Scott Chacon, 6 years ago : Remove unnecessary test
a11bef0 - Scott Chacon, 6 years ago : Initial commit

git log --pretty=format 的有用指定符列出了 format 接受的一些更有用的指定符。

表 1. `git log --pretty=format` 的有用指定符
指定符	输出描述
`%H`	提交哈希
`%h`	缩写提交哈希
`%T`	树哈希
`%t`	缩写树哈希
`%P`	父哈希
`%p`	缩写父哈希
`%an`	作者姓名
`%ae`	作者电子邮件
`%ad`	作者日期（格式遵循 `--date=option`）
`%ar`	作者日期，相对
`%cn`	提交者姓名
`%ce`	提交者电子邮件
`%cd`	提交者日期
`%cr`	提交者日期，相对
`%s`	主题

你可能想知道作者和提交者有什么区别。作者是最初编写作品的人，而提交者是最后应用作品的人。因此，如果你向一个项目发送一个补丁，并且其中一个核心成员应用了该补丁，那么你们俩都会得到认可——你作为作者，核心成员作为提交者。我们将在分布式 Git 中更详细地介绍这种区别。

oneline 和 format 选项值与另一个 log 选项 --graph 特别有用。此选项添加了一个漂亮的 ASCII 图形，显示你的分支和合并历史：

$ git log --pretty=format:"%h %s" --graph
* 2d3acf9 Ignore errors from SIGCHLD on trap
*  5e3ee11 Merge branch 'master' of https://github.com/dustin/grit.git
|\
| * 420eac9 Add method for getting the current branch
* | 30e367c Timeout code and tests
* | 5a09431 Add timeout protection to grit
* | e1193f8 Support for heads with slashes in them
|/
* d6016bc Require time for xmlschema
*  11d191e Merge branch 'defunkt' into local

随着我们在下一章中讨论分支和合并，这种输出类型将变得更加有趣。

这些只是 git log 的一些简单输出格式选项——还有更多。 git log 的常用选项列出了我们目前介绍的选项，以及一些其他可能有用的常见格式选项，以及它们如何改变 log 命令的输出。

表 2. `git log` 的常用选项
选项	描述
`-p`	显示每次提交引入的补丁。
`--stat`	显示每次提交中修改的文件统计信息。
`--shortstat`	只显示 `--stat` 命令中的更改/插入/删除行。
`--name-only`	在提交信息之后显示修改的文件列表。
`--name-status`	显示受影响的文件列表，并包含添加/修改/删除信息。
`--abbrev-commit`	只显示 SHA-1 校验和的前几个字符，而不是全部 40 个字符。
`--relative-date`	以相对格式（例如，“2 weeks ago”）显示日期，而不是使用完整日期格式。
`--graph`	在日志输出旁边显示分支和合并历史的 ASCII 图形。
`--pretty`	以备用格式显示提交。选项值包括 `oneline`、`short`、`full`、`fuller` 和 `format`（其中你指定自己的格式）。
`--oneline`	`--pretty=oneline --abbrev-commit` 组合的简写。

限制日志输出

除了输出格式选项之外，git log 还接受许多有用的限制选项；也就是说，允许你只显示一部分提交的选项。你已经看到了一个这样的选项——-2 选项，它只显示最后两次提交。实际上，你可以使用 -<n>，其中 n 是任何整数来显示最后 n 次提交。实际上，你不太可能经常使用它，因为 Git 默认将所有输出通过寻呼器管道传输，因此你一次只能看到一页日志输出。

然而，时间限制选项，例如 --since 和 --until 非常有用。例如，此命令获取过去两周内进行的提交列表：

$ git log --since=2.weeks

此命令适用于多种格式——你可以指定一个特定日期，例如 "2008-01-15"，或一个相对日期，例如 "2 years 1 day 3 minutes ago"。

你还可以将列表筛选为符合某些搜索条件的提交。--author 选项允许你根据特定作者进行筛选，而 --grep 选项允许你在提交信息中搜索关键字。

注意	你可以指定多个 `--author` 和 `--grep` 搜索条件实例，这将把提交输出限制为与任何 `--author` 模式和任何 `--grep` 模式匹配的提交；但是，添加 `--all-match` 选项会进一步将输出限制为只匹配所有 `--grep` 模式的那些提交。

另一个非常有用的过滤器是 -S 选项（俗称 Git 的“鹤嘴锄”选项），它接受一个字符串，并且只显示那些更改了该字符串出现次数的提交。例如，如果你想查找添加或删除了对特定函数的引用的最后一次提交，你可以调用：

$ git log -S function_name

最后一个作为过滤器传递给 git log 的非常有用的选项是路径。如果你指定一个目录或文件名，你可以将日志输出限制为对这些文件引入更改的提交。这总是最后一个选项，并且通常前面有双破折号 (--) 以将路径与选项分开：

$ git log -- path/to/file

在限制 git log 输出的选项中，我们将列出这些以及其他一些常用选项供你参考。

表 3. 限制 `git log` 输出的选项
选项	描述
`-<n>`	只显示最后 n 次提交。
`--since`, `--after`	将提交限制为在指定日期之后进行的提交。
`--until`, `--before`	将提交限制为在指定日期之前进行的提交。
`--author`	只显示作者条目与指定字符串匹配的提交。
`--committer`	只显示提交者条目与指定字符串匹配的提交。
`--grep`	只显示提交信息包含该字符串的提交。
`-S`	只显示添加或删除与字符串匹配的代码的提交。

例如，如果你想查看 Git 源代码历史中哪些修改测试文件的提交是由 Junio Hamano 在 2008 年 10 月提交的，并且不是合并提交，你可以运行以下命令：

$ git log --pretty="%h - %s" --author='Junio C Hamano' --since="2008-10-01" \
   --before="2008-11-01" --no-merges -- t/
5610e3b - Fix testcase failure when extended attributes are in use
acd3b9e - Enhance hold_lock_file_for_{update,append}() API
f563754 - demonstrate breakage of detached checkout with symbolic link HEAD
d1a43f2 - reset --hard/read-tree --reset -u: remove unmerged new paths
51a94af - Fix "checkout --track -b newbranch" on detached HEAD
b0ad11e - pull: allow "git pull origin $something:$current_branch" into an unborn branch

在 Git 源代码历史中近 40,000 次提交中，此命令显示了符合这些条件的 6 次提交。

提示	阻止显示合并提交根据你在仓库中使用的工作流程，你的日志历史中可能相当一部分提交只是合并提交，这些提交通常信息量不大。为了防止合并提交使你的日志历史混乱，只需添加 `log` 选项 `--no-merges`。

1. 起步

2. Git 基础

3. Git 分支

4. 服务器上的 Git

5. 分布式 Git

6. GitHub

7. Git 工具

8. 定制 Git

9. Git 与其他系统

10. Git 内部原理

A1. 附录 A: Git 在其他环境

A2. 附录 B: 在应用程序中嵌入 Git

A3. 附录 C: Git 命令

2.3 Git 基础 - 查看提交历史

查看提交历史

限制日志输出