Git学习教程（六）Git日志

时间 2021-01-19

标签 html git web apache app xss ide 翻译 3d 日志栏目 Git 繁體版

原文原文链接

第六课 Git 日志

内容提要：浏览项目历史，查询指定提交内容，图形化显示分枝和合并...

'git log'是git中最经常使用的一个命令，执行以后，会显示该项目的提交历史。若是命令不加任何参数，那么就会显示目前所在分枝上，从最后一次提交开始，按时间顺序依次向前排列的全部提交历史记录。

$ git log
commit 166ae0c4d3f420721acbb115cc33848dfcc2121a
Author: Scott Chacon < schacon@gmail.com >
Date: Sun Feb 8 16:50:43 2009 -0800

started write support

commit 9fceb02d0ae598e95dc970b74767f19372d61af8
Author: Magnus Chacon < mchacon@gmail.com >
Date: Sun Apr 27 20:43:35 2008 -0700

updated rakefile

commit 964f16d36dfccde844893cac5b347e7b3d44abbc
Author: Magnus Chacon < mchacon@gmail.com >
Date: Sun Apr 27 20:34:23 2008 -0700

commit the todo

上面显示了3次提交，对于每一次的提交都会显示四方面内容，分别是：

*提交的校验和
*做者信息（做者名和email地址）
*提交日期
*提交信息

这是git日志默认输出的提交历史的内容格式。多数状况下，这样输出仍是比较完美的。然而，有时候你只是想看到某个分枝上的最后几条提交信息，或者某些感兴趣的数据，只要在'git log'命令后面加上相应的参数，它就能够作更多有意义的事情。

日志输出格式

经过'git log'命令还能有不少种可选的输出格式。

显示补丁

你能够查看每一次提交条目的补丁内容，只须要在'git log'后加上-p选项，这在代码复查时很管用--在合并到你的某个分枝以前查看是其余做者提交了什么内容，或者是看看在最后发布以前所作的修改。

$ git log -p
commit 0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc
Author: Scott Chacon < schacon@gmail.com >
Date: Sun Feb 8 18:29:31 2009 -0800

added a commit function

diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index dd6b7b3..c75a3e6 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -9,6 +9,10 @@ class SimpleGit
command("git status")
end

+ def commit(message)
+    command("git commit -m '#{message}'")
+ end
+
   def show(treeish = 'master')
     command("git show #{treeish}")
   end

commit 166ae0c4d3f420721acbb115cc33848dfcc2121a
Author: Scott Chacon < schacon@gmail.com >
Date: Sun Feb 8 16:50:43 2009 -0800

started write support

diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index dd6b7b3..e7dfaa9 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -9,6 +9,10 @@ class SimpleGit
command("git status")
end

+ def add(path)
+    command("git add #{path}")
+ end
+
   def show(treeish = 'master')
     command("git show #{treeish}")
   end

内容至关的冗长，可是这些输出都是分页的，因此一旦你获得了你须要的信息，后面的提交内容就能够都跳过了。

查看统计数字

你能够经过执行'git log -stat'命令，来显示被修改文件的修改统计信息，添加或删除了多少行。

$ git log --stat
commit 0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc
Author: Scott Chacon < schacon@gmail.com >
Date: Sun Feb 8 18:29:31 2009 -0800

added a commit function

lib/simplegit.rb | 4 ++++
1 files changed, 4 insertions(+), 0 deletions(-)

commit 166ae0c4d3f420721acbb115cc33848dfcc2121a
Author: Scott Chacon < schacon@gmail.com >
Date: Sun Feb 8 16:50:43 2009 -0800

started write support

lib/simplegit.rb | 4 ++++
1 files changed, 4 insertions(+), 0 deletions(-)

调整显示格式

使用'git log --pretty=format'命令，能够将提交历史显示成你想要的格式。这里format的可选项包括：oneline，short，medium，full，fuller，email，raw。每种格式都有侧重的显示相关内容。

$ git log --pretty=raw
commit 0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc
tree dbcff814ec9fbbd3487171a7eaca73cf0069ba53
parent 85211d1138cb91f25c0633d361ff5f6e00677bc5
author Scott Chacon < schacon@gmail.com > 1234146571 -0800
committer Scott Chacon < schacon@gmail.com > 1234146571 -0800

added a commit function

commit 166ae0c4d3f420721acbb115cc33848dfcc2121a
tree e67636948570e27a9c2bf2699ecafadf729c3efc
parent 9fceb02d0ae598e95dc970b74767f19372d61af8
author Scott Chacon < schacon@gmail.com > 1234140643 -0800
committer Scott Chacon < schacon@gmail.com > 1234140643 -0800

started write support

这里，最经常使用的一种格式是'oneline', 每一行表示一次提交，一行内容包括校验和与提交信息两项内容。这种显示格式能够很简洁的显示大量的提交信息。

$ git log --pretty=oneline
0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function
166ae0c4d3f420721acbb115cc33848dfcc2121a started write support
9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile
964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo
8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
a5f4a0daa9b13bb85283461ddaba6e589e34ccb5 added cat-file

自定义格式

若是你但愿git输出自定义的提交信息，你可使用这样的命令：git log --pretty=format:"(format)".能够在""内自定义字符串与Git变量相结合的显示格式，在输出时，git会自动的将变量的位置输出为所需内容。

$ git log --pretty=format:"The author of %h was %an, %ar%nThe title was >>%s<<%n"
The author of 0b7434d was Scott Chacon, 18 hours ago
The title was >>added a commit function<<

The author of 166ae0c was Scott Chacon, 20 hours ago
The title was >>started write support<<

The author of 9fceb02 was Magnus Chacon, 10 months ago
The title was >>updated rakefile<<

The author of 964f16d was Magnus Chacon, 10 months ago
The title was >>commit the todo<<

The author of 8a5cbc4 was Scott Chacon, 5 months ago
The title was >>updated readme<<

更多详细自定义格式方法能够参考 git log docs 。

分枝拓扑图

还有一个日志输出选项是-graph，这个选项与--pretty=oneline结合不只能够显示提交历史并且还会显示图形化的分枝拓扑

$ git log --pretty=oneline --graph
*   15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'
|\
| * a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support
* |   4a447f750f910445e38338aadef48f3038b35d2b sweet
|\ \
| |/
| * 0d52aaab4479697da7686c15f77a3d64d9165190 one more thing
* |   6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'
|\ \
| |/
| * 4682c3261057305bdd616e23b64b0857d832627b added a todo file
| * ebe0d698d3def0ec43f9b883857717de8c405d96 removed the todo file
| * 166ae0c4d3f420721acbb115cc33848dfcc2121a started write support
* | 0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function
* | 85211d1138cb91f25c0633d361ff5f6e00677bc5 removed todo file
|/
* 9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile

提交查询过滤器

利用提交查询过滤器能够查询通过某些条件限制后获得的提交信息。

日期区间

'git log'命令后若是跟-before和-after选项，就会显示两个日期之间的提交条目。日期格式也有不一样的可选格式。例如，我想查看1月26号以后，2个星期以前的提交内容，能够运行：

$ git log --before="2 weeks ago" --after="2009-01-26" --pretty=oneline
dfb047b9e4f7f66c5322ef642f21fd92b0a975e3 Mention "local convention" rule in t
25655221745fd27d5da3bda7ad0fe49f2005d776 Windows: Revert to default paths and
35fb0e8633217f602360a9987af51c4b960e7850 Compute prefix at runtime if RUNTIME
8e3462837b0ace04357503a3f58802cc2231df29 Modify setup_path() to only add git_
2fb3f6db96492b680899f9e40f434eeb4c778a84 Add calls to git_extract_argv0_path(
2cd72b0b290e40fb4d6a925ce26603503f01aa09 git_extract_argv0_path(): Move check
4dd47c3b867f51211d0dc4474dab0fee5ca614da Refactor git_set_argv0_path() to git
026fa0d5ad9538ca76838070861531c037d7b9ba Move computation of absolute paths f

贡献者过滤器

git还能够经过贡献者过滤器来查看某个做者发起的提交。在commit对象中实际上存在两我的的记录--一个是做者(author)，也就是作原始提交的人。第二我的名是提交者(committer)，就是提交到仓库中的人。在这里找不到合适的翻译，因此把两者统称为 贡献者。通常状况下，所指的都是同一我的，可是在某些状况下就不是了--譬如，有一个做者将他写的东西email给项目持有人，这个项目持有人就是提交者(committer)，项目持有人将做者提交的东西提交到git仓库中。

大多数状况搜索的是做者，固然你能够经过-author或者-committer加名字的方式来搜索相应的提交条目。下面这个例子咱们是执行命令来查找做者名（author）为Johannes Schindelin，在过去两周内的全部提交条目：

$ git log --author=johannes.schindelin --since="14 days ago" --pretty=oneline
26be15f09db15d2b53a13d0f184d77fb54367f33 filter-branch: do not consider diver
e1e4389832f32bb6ce029d6a6b110aa9ec768ea8 apply: fix access to an uninitialize
418566b6fdcc0eb1b5549d0742366aa13a7ff277 Fix 'git diff --no-index' with a non
f7951e1d97aeb7b3ed359faeab5edf9e870ec8a5 Simplify t3412
37e5c8f46042510176a71d73c903c44214e09815 Simplify t3411
4bd03d15e495086a38470b59447296db4c235cb9 Simplify t3410
008849689e04e774aa7b194cd690405761e2383a test-lib.sh: introduce test_commit()
03af0870a0e6d551a31eb830d5c2682b82ae0ac6 lib-rebase.sh: Document what set_fak
29a03348a336f28025c824436a713cb9cb01b7a6 t3404 & t3411: undo copy&paste
b8469ad0578d6b84ec92752a5f8df3ca5828af77 test-path-utils: Fix off by one, fou
f265458f6116a0c03200477ae3b839f2a75bf0fa get_sha1_basic(): fix invalid memory

你能够指定完整人名或email地址来搜索，你也可使用这些值的部份内容来查询，譬如，搜索Junio Hamano做者的提交内容，能够执行下面的任意一条语句：

$ git log --author=Junio
$ git log --author=Hamano
$ git log --author="Junio C Hamano"
$ git log --author=gitster@pobox.com

咱们甚至还能够经过'gmail.com'来搜索，结果就是email主机地址为gmail.com的贡献者所做提交的内容。

$ git log --author=gmail --pretty=format:"%ae" | wc -l
1348
$ git log --author=gmail --pretty=format:"%ae" | sort -u | wc -l
113

从这两个命令执行以后的结果看到，Git源码项目有113个gmail帐户的做者贡献的1348个补丁。有趣的是，没有一个做者使用hotmail帐户，可是有81个补丁来自'.mil'（都出自一我的）。

$ git log --author='\.mil' --pretty=format:"%ae" | wc -l
81

查找提交信息

若是你对“提交信息”更感兴趣，你能够经过提交信息里面的某个字符串来查找相应的提交。例如，下面是搜索在提交信息中含有'c90'的全部提交内容。

$ git log --grep='C90' --pretty=oneline
8c9e7947c2a76fb21bda11816c544d50e271156d http-push.c: squelch C90 warnings.

文件历史

还有的时候，你但愿查看某个指定文件的提交历史。譬如你但愿查看'notes.c'文件每一次的提交历史，你能够运行：

$ git log --pretty=oneline -- notes.c
22a3d060937072b0f197a8084af879c753c68fe7 git-notes: fix printing of multi-lin
2dd625d022074bb677bdd5caa5146cabaf726123 Speed up git notes lookup
879ef2485d6ced20845ca626ecb45a9b65aa3a70 Introduce commit notes

你还能够对文件目录进行这样的操做，譬如你想查看't/lib-httpd'目录的提交历史：

$ git log --pretty=oneline --all -- t/lib-httpd/
466ddf90c2f270b973d141f20e912f743743331c http-push: when making directories,
603fb1168218a813f1b0816b1208c5d0c92cf29d Avoid apache complaining about lack
faa4bc35a05ddb1822f3770cd8c51859e3b929ee http-push: add regression tests

也能够加入多个查询项目，譬如要查看't/lib-httpd'目录或notes.c文件的提交历史：

$ git log --pretty=oneline -- t/lib-httpd/ notes.c
7b75b331f6744fbf953fe8913703378ef86a2189 Merge branch 'js/notes'
466ddf90c2f270b973d141f20e912f743743331c http-push: when making directories,
22a3d060937072b0f197a8084af879c753c68fe7 git-notes: fix printing of multi-lin
2dd625d022074bb677bdd5caa5146cabaf726123 Speed up git notes lookup
879ef2485d6ced20845ca626ecb45a9b65aa3a70 Introduce commit notes
603fb1168218a813f1b0816b1208c5d0c92cf29d Avoid apache complaining about lack
faa4bc35a05ddb1822f3770cd8c51859e3b929ee http-push: add regression tests

其余选项

不少时候想查看未合并的提交历史记录，因此你能够加上'--no-merges'选项

$ git log --grep='C90' --pretty=oneline --no-merges
8c9e7947c2a76fb21bda11816c544d50e271156d http-push.c: squelch C90 warnings.
8f1d2e6f49ee51ac062ab38337a6a70dd1998def [PATCH] Compilation: zero-length arr
01c6ad29bd1b647d4fd1acea54e374c740ec3c10 [PATCH] Fix strange timezone handlin

还能够在查看日志命令最后加上-N来查看知足条件的最近的N条历史记录：

$ git log --pretty=oneline --no-merges -5
621f1b4bcf40f1469fc59202248df35619e33c82 GIT 1.6.2-rc0
7851386948dce72c739bcdfe08f069afe4f5ea45 emacs: Remove the no longer maintain
5a7b3bf5275adf86fdd23f8824562b88c8a20e33 git.el: Add some notes about Emacs v
6c4f70d5b2fb8f9275ca85e0927f00b8bc892819 git.el: Use integer instead of chara
efd49f50fc087df2ad46f194ca848c5335f4cca9 git.el: Set a regexp for paragraph-s

若是下面是咱们的提交历史：

$ git log --pretty=oneline --graph
* 9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile
* 964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo
* 8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
* a5f4a0daa9b13bb85283461ddaba6e589e34ccb5 added cat-file
* 310154e3c7db47d8bac935c2c43aee6afac11aae updated README formatting and adde
* f7f3f6dd8fd3fa40f052427c32785a0fa01aaa5f changed my name a bit
* 710f0f8d2cdf5af87033b9ec08859a505f9a6af5 added ls-files
* c110d7ff8cfb86fd5cce9a8aee462678dbb4ef9b made the ls-tree function recursiv
* ce9b0d5551762048735dd67917046b44176317e0 limiting log to 30

咱们但愿只看到提交信息为'added Is-files'以后，'updated readme'以前的提交历史，咱们能够这样指定查询：

[master]$ git log --pretty=oneline 710f0f..8a5cbc
8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
a5f4a0daa9b13bb85283461ddaba6e589e34ccb5 added cat-file
310154e3c7db47d8bac935c2c43aee6afac11aae updated README formatting and added
f7f3f6dd8fd3fa40f052427c32785a0fa01aaa5f changed my name a bit

若是你在查找一个分枝上的提交时，这样作很是管用。譬如，你目前在'master'分枝上，而且想查看'experiment'分枝上尚未合并的提交记录的话，能够这样：

$ git log master..experiment --pretty=oneline
f6b98e46bdf64454d7c6ab76d617237118799d7b git-web--browse: Fix check for /bin/
df487baa30924a36ade38ada4f77379236dcce0f Merge branch 'maint'
a9ee90d7ff9f3854b3096b4abbdc2013708704f5 completion: Get rid of tabbed indent
cf9957875c3a27b6ae4593e1fa9d4dabbde68433 completion: Fix GIT_PS1_SHOWDIRTYSTA
7e1100e9e939c9178b2aa3969349e9e8d34488bf gitweb: add $prevent_xss option to p

这就告诉你，若是如今合并的话，那么全部列出的这些提交都会被合并。你也能够不写某一端的分枝名，git会判断你目前正在哪一个分枝上，因此，若是你在master分枝上的话，下面的命令执行结果和上面的同样：

$ git log ..experiment --pretty=oneline

若是你在experiment分枝上，也想看到相同的信息，即尚未合并到master的提交，能够运行：

$ git log master.. --pretty=oneline

这一节讲的都是很经常使用的命令，下一课将深刻剖析这些内容，可是这一节课最关键的是记住这些命令和它的做用。