## git log 过滤你的提交历史记录
通过查看分支中另一分支看不到的提交记录，我们已经看到如何用 `git log` 来比较分支。 （如果你不记得了，它看起来是这样的：`git log branchA ^branchB`）。 而且，你也可以用`git log` 去寻找特定的提交。 在此，我们会看到一些更广为使用的 `git log` 选项，不过哪有很多。 完整的清单可以看看官方文档。
### git log –author 只寻找某个特定作者的提交
要过滤你的提交历史，只寻找某个特定作者的提交，你可以使用 `--author` 选项。 例如，比方说我们要找 Git 源码中 Linus 提交的部分。 我们可以执行类似 `git log --author=Linus` 的命令。 这个查找是大小写敏感的，并且也会检索电子邮箱地址。 我在此例中使用 `-[number]` 选项，以限制结果为最近 [number] 次的提交。
~~~
$ git log --author=Linus --oneline -5
81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
3bb7256 make "index-pack" a built-in
377d027 make "git pack-redundant" a built-in
b532581 make "git unpack-file" a built-in
112dd51 make "mktag" a built-in
~~~
### git log –since –before 根据日期过滤提交记录
如果你要指定一个你感兴趣的日期范围以过滤你的提交，可以执行几个选项 —— 我用 `--since` 和 `--before`，但是你也可以用 `--until` 和 `--after`。 例如，如果我要看 Git 项目中三周前且在四月十八日之后的所有提交，我可以执行这个（我还用了 `--no-merges` 选项以隐藏合并提交）：
~~~
$ git log --oneline --before={3.weeks.ago} --after={2010-04-18} --no-merges
5469e2d Git 1.7.1-rc2
d43427d Documentation/remote-helpers: Fix typos and improve language
272a36b Fixup: Second argument may be any arbitrary string
b6c8d2d Documentation/remote-helpers: Add invocation section
5ce4f4e Documentation/urls: Rewrite to accomodate transport::address
00b84e9 Documentation/remote-helpers: Rewrite description
03aa87e Documentation: Describe other situations where -z affects git diff
77bc694 rebase-interactive: silence warning when no commits rewritten
636db2c t3301: add tests to use --format="%N"
~~~
### git log –grep 根据提交注释过滤提交记录
你或许还想根据提交注释中的某个特定短语查找提交记录。可以用 `--grep` 选项。 比如说我知道有个提交是有关使用 P4EDITOR 环境变量，又想回忆起那个改动是啥样子的 —— 我可以用`--grep` 选项找到该提交。
~~~
$ git log --grep=P4EDITOR --no-merges
commit 82cea9ffb1c4677155e3e2996d76542502611370
Author: Shawn Bohrer
Date: Wed Mar 12 19:03:24 2008 -0500
git-p4: Use P4EDITOR environment variable when set
Perforce allows you to set the P4EDITOR environment variable to your
preferred editor for use in perforce. Since we are displaying a
perforce changelog to the user we should use it when it is defined.
Signed-off-by: Shawn Bohrer
Signed-off-by: Simon Hausmann
~~~
Git 会对所有的 `--grep` 和 `--author` 参数作逻辑或。 如果你用 `--grep` 和 `--author` 时，想看的是某人写作的并且有某个特殊的注释内容的提交记录， 你需要加上 `--all-match` 选项。 在这些例子中，我会用上 `--format` 选项，这样我们就可以看到每个提交的作者是谁了。
如果我查找注释内容含有 “p4 depo”的提交，我得到了三个提交：
~~~
$ git log --grep="p4 depo" --format="%h %an %s"
ee4fd1a Junio C Hamano Merge branch 'master' of git://repo.or.cz/git/fastimport
da4a660 Benjamin Sergeant git-p4 fails when cloning a p4 depo.
1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
~~~
如果我加上 `--author=Hausmann` 参数，与进一步过滤上述结果到 Simon 的唯一提交相反， 它会告诉我所有 Simon 的提交，或者注释中有“p4 demo”的提交：
~~~
$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann"
cdc7e38 Simon Hausmann Make it possible to abort the submission of a change to Pe
f5f7e4a Simon Hausmann Clean up the git-p4 documentation
30b5940 Simon Hausmann git-p4: Fix import of changesets with file deletions
4c750c0 Simon Hausmann git-p4: git-p4 submit cleanups.
0e36f2d Simon Hausmann git-p4: Removed git-p4 submit --direct.
edae1e2 Simon Hausmann git-p4: Clean up git-p4 submit's log message handling.
4b61b5c Simon Hausmann git-p4: Remove --log-substitutions feature.
36ee4ee Simon Hausmann git-p4: Ensure the working directory and the index are cle
e96e400 Simon Hausmann git-p4: Fix submit user-interface.
38f9f5e Simon Hausmann git-p4: Fix direct import from perforce after fetching cha
2094714 Simon Hausmann git-p4: When skipping a patch as part of "git-p4 submit" m
1ca3d71 Simon Hausmann git-p4: Added support for automatically importing newly ap
...
~~~
不过，如果加上 `--all-match`，结果就是我想要的了：
~~~
$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann" --all-match
1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
~~~
### git log -S 依据所引入的差值过滤
如果你写的提交注释都极度糟糕怎么办？或者，如果你要找某个函数是何时引入的，某些变量是在哪里开始被使用的？ 你可以告诉 Git 在每个提交之间的差值中查找特定字符串。 例如，如果我们想要找出哪个提交修改出了类似函数名“userformat_find_requirements”， 我们可以执行（注意在“-S”与你要找的东东之间没有“=”）：
~~~
$ git log -Suserformat_find_requirements
commit 5b16360330822527eac1fa84131d185ff784c9fb
Author: Johannes Gilger
Date: Tue Apr 13 22:31:12 2010 +0200
pretty: Initialize notes if %N is used
When using git log --pretty='%N' without an explicit --show-notes, git
would segfault. This patches fixes this behaviour by loading the needed
notes datastructures if --pretty is used and the format contains %N.
When --pretty='%N' is used together with --no-notes, %N won't be
expanded.
This is an extension to a proposed patch by Jeff King.
Signed-off-by: Johannes Gilger
Signed-off-by: Junio C Hamano
~~~
### git log -p 显示每个提交引入的补丁
每个提交都是项目的一个快照。由于每个提交都记录它所基于的快照，Git 能够经常对它们求差值，并以补丁形式向你展示。 这意味着，对任意提交，你都可以获取该提交给项目引入补丁。 你可以用 `git show [SHA]` 加上某个特定的提交 SHA 获取，或者执行 `git log -p`， 它会告诉 Git 输出每个提交之后的补丁。这是个总结某一分支或者两个提交之间都发生了神马的好途径。
~~~
$ git log -p --no-merges -2
commit 594f90bdee4faf063ad07a4a6f503fdead3ef606
Author: Scott Chacon
Date: Fri Jun 4 15:46:55 2010 +0200
reverted to old class name
diff --git a/ruby.rb b/ruby.rb
index bb86f00..192151c 100644
--- a/ruby.rb
+++ b/ruby.rb
@@ -1,7 +1,7 @@
-class HiWorld
+class HelloWorld
def self.hello
puts "Hello World from Ruby"
end
end
-HiWorld.hello
+HelloWorld.hello
commit 3cbb6aae5c0cbd711c098e113ae436801371c95e
Author: Scott Chacon
Date: Fri Jun 4 12:58:53 2010 +0200
fixed readme title differently
diff --git a/README b/README
index d053cc8..9103e27 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-Hello World Examples
+Many Hello World Examples
======================
This project has examples of hello world in
~~~
这是个总结改动，以及合并或发布之前重审一系列提交的好方式。
### git log –stat 显示每个提交引入的改动的差值统计
如果 `-p` 选项对你来说太详细了，你可以用 `--stat` 总结这些改动。 这是不用 `-p`，而用 `--stat` 选项时，同一份日志的输出。
~~~
$ git log --stat --no-merges -2
commit 594f90bdee4faf063ad07a4a6f503fdead3ef606
Author: Scott Chacon
Date: Fri Jun 4 15:46:55 2010 +0200
reverted to old class name
ruby.rb | 4 ++--
1 files changed, 2 insertions(+), 2 deletions(-)
commit 3cbb6aae5c0cbd711c098e113ae436801371c95e
Author: Scott Chacon
Date: Fri Jun 4 12:58:53 2010 +0200
fixed readme title differently
README | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
~~~
同样的基本信息，但更紧凑 —— 它仍然让你看到相对改动，和改动了哪些文件。
