git log的使用

作者：雪轩辕
链接：https://www.jianshu.com/p/0805b5d5d893

一、无参数状态

git log

默认不用任何参数的话，git log 会按提交时间列出所有的更新，最近的更新排在最上面。每次更新都有一个 SHA-1 校验和、作者的名字 和 电子邮件地址、提交时间，最后缩进一个段落显示提交说明。

二、参数的说明

代码审查-展开内容差异: git log -p

展开显示每次提交的内容差异, 用 -2 则仅显示最近的两次更新。

git log -p -2

在做代码审查，或者要快速浏览其他协作者提交的更新都作了哪些改动时，就可以用这个选项。

三、增改行数统计 git log --stat

仅显示简要的增改行数统计。

git log --stat 

每个提交都列出了修改过的文件，以及其中添加和移除的行数，并在最后列出所有增减行数小计。

四、格式化提交日志git log --pretty

可以指定使用完全不同于默认格式的方式展示提交历史。

1、简单模式

git log --pretty=oneline
git log --pretty=short
git log --pretty=full
git log --pretty=fuller

2、定制格式

定制格式 format，可以定制要显示的记录格式，这样的输出便于后期编程提取分析：

git log --pretty=format:"%h - %an, %ar : %s"

常用的格式占位符写法及其代表的意义:

选项	说明
%H	提交对象（commit）的完整哈希字串
%h	提交对象的简短哈希字串
%T	树对象（tree）的完整哈希字串
%t	树对象的简短哈希字串
%P	父对象（parent）的完整哈希字串
%p	父对象的简短哈希字串
%an	作者（author）的名字
%ae	作者的电子邮件地址
%ad	作者修订日期（可以用 -date= 选项定制格式）
%ar	作者修订日期，按多久以前的方式显示
%cn	提交者(committer)的名字
%ce	提交者的电子邮件地址
%cd	提交日期
%cr	提交日期，按多久以前的方式显示
%s	提交说明

你一定奇怪 作者（author） 和 提交者（committer） 之间究竟有何差别，其实作者指的是实际作出修改的人，提交者指的是最后将此工作成果提交到仓库的人。所以，当你为某个项目发布补丁，然后某个核心成员将你的补丁并入项目时，你就是作者，而那个核心成员就是提交者。我们会在第五章再详细介绍两者之间的细微差别。

用 oneline 或 format 时结合 --graph 选项，可以看到开头多出一些 ASCII 字符串表示的简单图形，形象地展示了每个提交所在的分支及其分化衍合情况。在我们之前提到的 Grit 项目仓库中可以看到：

git log --pretty=format:"%h %s" --graph

以上只是简单介绍了一些 git log 命令支持的选项。表 2-2 还列出了一些其他常用的选项及其释义。

选项	说明
-p	按补丁格式显示每个更新之间的差异。
–stat	显示每次更新的文件修改统计信息。
–shortstat	只显示 --stat 中最后的行数修改添加移除统计。
–name-only	仅在提交信息后显示已修改的文件清单。
–name-status	显示新增、修改、删除的文件清单。
–abbrev-commit	仅显示 SHA-1 的前几个字符，而非所有的 40 个字符。
–relative-date	使用较短的相对时间显示（比如，“2 weeks ago”）。
–graph	显示 ASCII 图形表示的分支合并历史。
–pretty	使用其他格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（后跟指定格式）。

五、限制输出长度

除了定制输出格式的选项之外，git log 还有许多非常实用的限制输出长度的选项，也就是只输出部分提交信息。之前我们已经看到过 -2 了，它只显示最近的两条提交，实际上，这是 - 选项的写法，其中的 n 可以是任何自然数，表示仅显示最近的若干条提交。不过实践中我们是不太用这个选项的，Git 在输出所有提交时会自动调用分页程序（less），要看更早的更新只需翻到下页即可。

另外还有按照时间作限制的选项，比如 --since 和 --until。

1、git log --since / git log --until

下面的命令列出所有最近两周内的提交：

$ git log --since=2.weeks

你可以给出各种时间格式，比如说具体的某一天（“2008-01-15”），或者是多久以前（“2 years 1 day 3 minutes ago”）。

2、git log --author=“”

显示指定作者的提交

PS D:\Work\git> git log --author=lizhijie429
commit f2e6323ffb48598cac55871208c99e95baf101de (HEAD -> main, origin/main)
Merge: ed685c6 0df18f6
Author: lizhijie429 <632163606@qq.com>
Date:   Thu Jun 23 15:13:25 2022 +0800

    Merge branch 'main' of http://10.188.186.140/test/git-test

commit ed685c6dfeace65b7ae5343170230a45def1c327
Author: lizhijie429 <632163606@qq.com>
Date:   Thu Jun 23 15:13:21 2022 +0800

    3

commit 0df18f689bc98f08765ff9ba3e9604b9acb0f3b6
:

3、git log --grep

用 --grep 选项搜索提交说明中的关键字。（请注意，如果要得到同时满足这两个选项搜索条件的提交，就必须用–all-match 选项。）

PS D:\Work\git> git log --grep 3
commit ed685c6dfeace65b7ae5343170230a45def1c327
Author: lizhijie429 <632163606@qq.com>
Date:   Thu Jun 23 15:13:21 2022 +0800

    3

commit 0df18f689bc98f08765ff9ba3e9604b9acb0f3b6
Author: lizhijie429 <632163606@qq.com>
Date:   Thu Jun 23 15:12:35 2022 +0800

    3
PS D:\Work\git> 

4、git log –

如果只关心某些文件或者目录的历史提交，可以在 git log 选项的最后指定它们的路径。因为是放在最后位置上的选项，所以用两个短划线（–）隔开之前的选项和后面限定的路径名。

表 2-3 还列出了其他常用的类似选项。

选项	说明
-(n)	仅显示最近的 n 条提交
–since, --after	仅显示指定时间之后的提交。
–until, --before	仅显示指定时间之前的提交。
–author	仅显示指定作者相关的提交。
–committer	仅显示指定提交者相关的提交。

来看一个实际的例子，如果要查看 Git 仓库中，2008 年 10 月期间，Junio Hamano 提交的但未合并的测试脚本（位于项目的 t/ 目录下的文件），可以用下面的查询命令：

$ git log --pretty="%h - %s" --author=gitster --since="2008-10-01" --before="2008-11-01" --no-merges --t
5610e3b - Fix testcase failure when extended attribute
acd3b9e - Enhance hold_lock_file_for_{update,append}()
f563754 - demonstrate breakage of detached checkout wi
d1a43f2 - reset --hard/read-tree --reset -u: remove un
51a94af - Fix "checkout --track -b newbranch" on detac
b0ad11e - pull: allow "git pull origin $something:$cur

Git 项目有 20,000 多条提交，但我们给出搜索选项后，仅列出了其中满足条件的 6 条。

作者：雪轩辕
链接：https://www.jianshu.com/p/0805b5d5d893
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

六、往期内容已全部收录在专栏中：

Flutter专栏_WEB前端李志杰的博客-CSDN博客

Vue专栏_WEB前端李志杰的博客-CSDN博客