Git命令进阶操作:过滤日志

本文会介绍一些使用git log命令查找特定提交历史的高级技巧。其中的一些技巧配合格式化日志命令使用有奇效。

按照数量过滤

使用git log命令时最基本的过滤方式就是按照可以显示的日志条数进行过滤。如果你只对最近几次提交感兴趣,这会节省在页面上查看所有提交的麻烦。

git log -3

按照日期过滤

如果你想查找特定时间段的提交历史,可以使用--after或者--before选项来通过日期过滤显示内容。这两个选项的值都可以接收不同形式的日期格式。比如下面的命令只显示2014年7月1日以及之后的提交历史信息。

git log --after="2014-7-1"

也可以传递相对时间比如"1 week ago"表示一周前或者"yesterday"表示昨天:

 git log --after="yesterday"

如果想寻找时间区间内的提交历史,可以同时使用--before--after选项。比如为了显示2014年7月1日到2014年7月4日之间提交可以向下面这样执行命令:

git log --after="2014-7-1" --before="2014-7-4"

此外需了解的是,git log命令中还可以使用--since--until选项,他们分别是--after--before的同义词。

按照作者过滤

如果想查找某个特定作者的提交历史,可以使用--author选项。该选项接受一个正则表达式,并且返回所有作者字段符合正则表达式的提交记录。当然如果你知道作者确切的名称,也可以直接传入一个普通字符串而无需使用正则表达式:

git log --author="John"

这条命令会显示所有由John提交的记录。作者名称并不是必须完全一致,检索时会匹配包含给定参数的提交记录。

你也可以通过使用正则表达式来构建更加复杂的搜索方式。比如下面的例子就会去搜索Mary或者John提交的记录。

git log --author="John\|Mary"

请注意在作者字段中也包含提交者的email值,所以你也可以使用此选项来搜索特定email地址。

如果你的工作流程区分提交人和作者,那么--committer选项操作也类似。

按照提交信息过滤

如果想按照提交信息过滤提交记录,可以使用--grep选项。它的工作方式与--author选项一致,只不过搜索的目标是提交信息而不是作者信息。

比如说你的团队规定提交信息中要包含对应的issue信息,那么就可以使用类似下面的命令来根据issue信息查找特定提交:

git log --grep="JRA-224:"

在使用时可以考虑传递-i选项让git log查找提交记录时忽略大小写。

按照文件过滤

很多时候,你可能只关心含有特定文件变更的提交。要想显示所有与这个文件相关的提交记录,那么可以将文件路径作为参数传递给git log命令。比如下面的例子会返回所有与foo.pybar.py文件有关的提交记录。

git log -- foo.py bar.py

--参数告诉git log命令接下来要传递的参数是文件路径而不是分支名称。如果你确定文件路径不会与分支名称混淆,也可以省略--

按照提交内容过滤

想要按照提交的具体内容来过滤提交记录,也是可以办到的。比如有时候你想知道添加或者删除某行代码的提交,可以使用-S""这样的参数,这被叫做pickaxe。比如如果你想知道Hello, World!这行代码是什么时候被添加到项目里的,那么就可以执行下面的命令:

git log -S"Hello, World!"

如果想以正则表达式进行搜索,而不是通过字符串,那么可以修改一下上面的命令,改为传入-G""这样的参数。

由于它提供了定位特定代码涉及到的所有提交记录的能力,这对于调试问题可能非常有用。这个命令甚至可以告诉你某行代码是什么时候被复制或者移动到另外一个文件的。

按照提交区间过滤

你可以向git log命令传递一个表示提交之间的区间来筛选仅在这两次提交之间的所有提交记录。对于区间的表示如下所示:

git log ..

这个命令对于查找两个分支之间的区别非常有用。考虑下面这个命令:

 git log main..feature

main..feature这个提交区间的表述,会给出所有已经存在于feature分支但还不存在于main分支的提交记录。换句话说,也就是feature分支已经距离main分支有多远了。可以通过下图来理解:

01 By Range.png

请注意如果你对调区间的两端(feature..main),你会得到所有已经存在于main分支但还未存在于feature分支的提交记录。如果git log命令在执行这两个区间时都有返回,那么也就意味着你的提交历史已经分叉了。

过滤合并提交

git log命令默认会含有合并提交。但是如果你的团队策略是“总是使用合并”(比如说总是在功能分支使用merge来整合上游分支的新变更,而不是将功能分支rebase到上游分支上),那么项目提交历史中会有大量冗余的合并提交节点。

通过传入--no-merges选项,可以让git log命令的输出过滤掉那些合并提交:

git log --no-merges

另外一方面,如果你只对合并提交感兴趣,也可以使用--merge选项

git log --merges

这会输出所有含有两个及以上分支的提交记录。

总结

这些新技能是Git工具包中的重要组成部分,git log命令经常与其他Git命令关联使用。一旦找到你所关心的那次提交,通常来说你都会需要使用git checkoutgit revert或者其他什么命令来操作这次提交。所以,还需持续不断的学习Git的高级功能。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,427评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,551评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,747评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,939评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,955评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,737评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,448评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,352评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,834评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,992评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,133评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,815评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,477评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,022评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,147评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,398评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,077评论 2 355

推荐阅读更多精彩内容