名称

git-log - 显示提交日志

概要

git log [<options>] [<revision range>] [[--] <path>…]

描述

不传入任何参数的默认情况下，git log 会按时间先后顺序列出所有的提交，最近的更新排在最上面。

这个命令会列出每个提交的 SHA-1 校验和、作者的名字和电子邮件地址、提交时间以及提交说明。

git log 有许多选项可以帮助你搜寻你所要找的提交， 下面介绍几个最常用的选项。

选项

限制输出长度

-<number>
-n <number>
--max-count=<number>

显示最近n条提交，如我们输入-2，则只显示最近2次的提交

--skip=<number>

Skip number commits before starting to show the commit output.

--since=<date>
--after=<date>

显示比指定时间之后的提交。

--until=<date>
--before=<date>

显示指定时间之前的提交。

--author=<pattern>
--committer=<pattern>

将提交输出限制为与指定模式（正则表达式）匹配的作者/提交者的提交。

--grep=<pattern>

仅显示提交说明中包含指定字符串的提交。

提交格式

--pretty[=<format>]
--format=<format>

使用其他格式显示历史提交信息。可用的选项包括 oneline、short、full、fuller 和format（用来定义自己的格式）。

这个选项有一些内建的子选项供你使用，比如 oneline 会将每个提交放在一行显示，在浏览大量的提交时非常有用。

另外还有 short，full 和 fuller 选项，它们展示信息的格式基本一致，但是详尽程度不一：

--abbrev-commit

仅显示 SHA-1 校验和所有 40 个字符中的前几个字符

--oneline

等于--pretty=oneline --abbrev-commit 合用的简写。

--graph

在日志旁以 ASCII 图形显示分支与合并历史。