第二版

2.3 Git 基础 - 查看提交历史

查看提交历史

在创建了多个提交之后，或者克隆了一个包含现有提交历史的仓库后，你可能希望回顾一下发生了什么。执行此操作最基本、最强大的工具是 git log 命令。

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

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

在该项目中运行 git log 时，你应该会得到如下所示的输出

$ git log
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <[email protected]>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <[email protected]>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <[email protected]>
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 <[email protected]>
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     =   "[email protected]"
     s.summary   =   "A simple gem for using Git in Ruby code."

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <[email protected]>
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

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

$ git log --stat
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <[email protected]>
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 <[email protected]>
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 <[email protected]>
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 选项值与另一个名为 --graph 的 log 选项特别有用。此选项添加了一个漂亮的 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 周前”），而不是使用完整日期格式。
`--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 基础 - 查看提交历史

查看提交历史

限制日志输出