[译]git log进阶
格式化log输出
oneline
--oneline标记将每个commit压缩成一行. 默认情况下显示一个commit ID和commit描述的第一行. 输出如下:
0e25143 Merge branch 'feature' ad8621a Fix a bug in the feature 16b36c6 Add a new feature 23ad9ad Add the initial code base
decorate
许多时候知道commit是和哪一个分支或tag关联的是非常有用的. --decorate标记会让git log显示每个commit的引用(如:分支、tag等).
可以和其它的config选项结合使用. 例如, git log --oneline --decorate输出如下:
0e25143 (HEAD, master) Merge branch 'feature' ad8621a (feature) Fix a bug in the feature 16b36c6 Add a new feature 23ad9ad (tag: v0.9) Add the initial code base
从中可以看出第一个commit在master分支. 第二个commit在一个feature分支, 第四个commit被tag为v0.9.
diffs
git log有许多选项是为了展示每个commit的不同之处的. 最常用的两个是--stat和-p.
--stat显示每个commit中每个文件的添加的行数和删除的行数.这对我们了解一个commit大致有些什么修改非常有用. 下面的commit hello.py新增了67行, 删除了38行:
commit f2a238924e89ca1d4947662928218a06d39068c3
Author: John <john@example.com>
Date: Fri Jun 25 17:30:28 2014 -0500
Add a new feature
hello.py | 105 ++++++++++++++++++++++++-----------------
1 file changed, 67 insertion(+), 38 deletions(-)
文件名后面的＋－符号是这个文件相对的增加和删除行数.
如果你想看每个commit具体修改了些什么可以使用git log -p, 结果如下:
commit 16b36c697eb2d24302f89aa22d9170dfe609855b
Author: Mary <mary@example.com>
Date: Fri Jun 25 17:31:57 2014 -0500
Fix a bug in the feature
diff --git a/hello.py b/hello.py
index 18ca709..c673b40 100644
--- a/hello.py
+++ b/hello.py
@@ -13,14 +13,14 @@ B
-print("Hello, World!")
+print("Hello, Git!")
shortlog
git shortlog是一个特殊版本的git log, 他的目的是为了创建一个发布的通知. 将commit按照作者分组, 显示每个commit的第一行描述. 通过他你很容易看到谁做了些什么.
例如, 两个开发者为一个项目贡献了5个commit, git shortlog的输出如下:
Mary (2):
Fix a bug in the feature
Fix a serious security hole in our framework
John (3):
Add the initial code base
Add a new feature
Merge branch 'feature'
默认情况下git shortlog按照作者名排序, 你可以使用-n按照每个作者的commit数量来排序.
graph
--graph标记会画出一个ASCII图展示commit历史的分支结构. 通常和--oneline --decorate结合使用:
git log --graph --oneline --decorate
* 0e25143 (HEAD, master) Merge branch 'feature' |\ | * 16b36c6 Fix a bug in the new feature | * 23ad9ad Start a new feature * | ad8621a Fix a critical security issue |/ * 400e4b7 Fix typos in the documentation * 160e224 Add the initial code base
星号告诉你commit在哪一个branch上,上面的输出告诉我们23ad9ad 和 16b36c6在一个主题分支, 其它的在master分支.
自定义输出
可以使用--pretty=format:"<string>"来自定义输出.
例如%cn代表commiter name, %h代表commit hash的缩写, %cd代表commiter date.
git log --pretty=format:"%cn committed %h on %cd"
输出如下:
John committed 400e4b7 on Fri Jun 24 12:30:04 2014 -0500 John committed 89ab2cf on Thu Jun 23 17:09:42 2014 -0500 Mary committed 180e223 on Wed Jun 22 17:21:19 2014 -0500 John committed f12ca28 on Wed Jun 22 13:50:31 2014 -0500
筛选commit历史
按数量
可以使用-n来限制输出的数量. 下面的例子只显示最近3个commit.
git log -3
按日期
可以使用--after或--before来按照日期筛选. 下面的例子只显示2014年7月1号之后的commit(包含7月1号).
git log --after="2014-7-1"
还可以使用一个相对的时间, 例如"1 week ago"和"yesterday""
git log --after="yesterday"
如果看某个时间段的commit可以同时使用--after和--before. 下面的例子显示2014年7月1日到2014年7月4日之间的commit:
git log --after="2014-7-1" --before="2014-7-4"
注意--since --until和 --after --before是一个意思.
按作者
git log --author="John"
显示John贡献的commit. 作者名不需要精确匹配--只需要包含就行了.
还可以使用正则表达式. 下面的命令搜索Marry和John贡献的commit.
git log --author="John\|Mary"
注意这个--author不仅包含名还包含email, 所以你可以用这个搜索email.
按commit描述
例如, 如果你的团队会在每个commit描述里面加上相关的issue号, 你可以使用下面的命令查找跟某个issue相关的commit:
git log --grep="JRA-224"
还可以传入-i用来忽略大小写.
按文件
有时你可能只对某个文件的修改感兴趣, 你只想查看跟某个文件相关的历史信息, 你只需要插入你感兴趣文件的路径就可以了. 下面的例子只返回和foo.py或bar.py相关的commit:
git log -- foo.py bar.py
这里的--是告诉Git后面的参数是文件路径而不是branch的名字. 如果后面的文件路径不会和某个branch产生混淆, 你可以省略--.
按内容
有时你想搜索和新增或删除某行代码相关的commit. 可以使用 －S"<string>". 下面的例子假设你想知道Hello, World!这句话是什么时候加入到项目里去的, 你可以使用下面的命令:
git log -S"Hello,World!"
如果你想使用正则表达式去匹配而不是字符串, 那么你可以使用-G代替-S.
这是一个非常有用的debug工具, 使用他你可以定位所有跟某行代码相关的commit. 甚至可以查看某行是什么时候被copy的, 什么时候移到另外一个文件中去的.
按范围
可以查看某个范围的commit:
git log <since>..<until>
这个命令非常有用当你使用branch做为range参数的时候. 能很方便的显示2个branch之间的不同. 看看下面的命令:
git log master..feature
master..feature这个range包含了在feature有而在master没有的所有commit. 如图所示(图中最下面的master..feature应该错了, 是feature..master才对):
feature..master包含所有master有但是feature没有的commit.
过滤merge commit
默认情况下git log会输出merge commit. 你可以通过--no-merges标记来过滤掉merge commit:
git log --no-merges
如果你只对merge commit感兴趣可以使用--merges:
git log --merges
