git log参数详解

例子

例子
git log --no-merges
显示整个提交历史，但跳过任何合并

git log v2.6.12… include/scsi drivers/scsi
显示自v2.6.12版本以来所有更改include/scsi或drivers/scsi子目录中 任何文件的提交

git log --since=“2 weeks ago” – gitk
显示最近两周对文件gitk的更改。在–避免与混乱是必要的分公司名为 gitk

git log --name-status release…test
显示在“测试”分支中但尚未在“发布”分支中的提交，以及每个提交修改的路径列表。

git log --follow builtin/rev-list.c
显示更改的提交builtin/rev-list.c，包括在为文件提供其当前名称之前发生的那些提交。

git log --branches --not --remotes=origin
显示在任何本地分支中但不在任何远程跟踪分支中的所有提交的提交。

git log master --not --remotes=*/master
显示所有在本地master中但不在任何远程存储库master分支中的提交。

git log -p -m --first-parent
仅从“主分支”角度显示包括更改差异的历史记录，跳过来自合并分支的提交，并显示合并引入的更改的完整差异。仅当在一个集成分支上遵循严格的合并所有主题分支的策略时，这才有意义。

git log -L ‘/int main/’,/^}/:main.c
显示main()文件中的功能如何main.c随时间演变。

git log -3
将提交的显示次数限制为3。

展示两个提交之间的所有提交

特殊符号“ .. ”可以用作“^ ”的简写

假设有如下提交记录，他们按时间逆序排列
7919e7674a467f0e5b1d13e99b26af5e6e1b212b ------( HEAD)
16705844a1f0d8e979fa838483d0b70860a9b786
16846670beabe3fed39e7e56bd91f2d52818d17b
8b6a2bb356c9f5cebc4ccc83d8faaacf62ca9dee ------(origin)

git log origin..HEAD 展示origin到HEAD不包含origin这次提交的其余所有提交

..前面的commit-id必须是更早地提交 不然将不会检索到结果，
比如：git log 8b6a2bb..7919e7674a46
展示了7919e7674a467f 16705844a1f0d 16846670beabe3f三次提交
而git log 7919e7674a4..8b6a2bb356的结果为空

git log HEAD ^origin 效果和git log origin..HEAD 是一样的 但是要注意 ^的位置 应该在更早的commit-id前面

git log ^8b6a2bb356 7919e7674a 和 git log 7919e7674a ^8b6a2bb356 效果是一样的
都展示了7919e7674a467f 16705844a1f0d 16846670beabe3f三次提交
而git log 8b6a2bb356 ^7919e7674a 将不会有任何结果展示

另一个特殊的表示法是“ … ”，这对合并很有用。提交的结果集是两个操作数之间的对称差。以下两个命令是等效的：
git log A B --not $(git merge-base --all A B)
git log A...B

筛选提交

--max-count= - -n 三者等效 限制要输出的提交数。
--skip= 跳过前number次提交
--since= --after=比指定日期更晚的提交
--until= --before=比指定日期更早地提交
--author= --committer=具有与指定模式（正则表达式）匹配的作者/提交者标题行的提交。
--grep=与指定模式（正则表达式）匹配的日志消息的提交。如果有多个–grep=提交，则选择其消息与任何给定模式匹配的提交

历史简化

有时只对历史的某些部分感兴趣，例如，修改特定 的提交。但是历史简化有两个部分 ，一个是选择提交，另一个是如何执行，因为有多种策略可以简化历史。
选择修改给定的提交。
--simplify-by-decoration
选择由某个分支或标签引用的提交。

请注意，可以显示额外的提交以提供有意义的历史记录。

以下选项影响简化的方式：

Default mode
将历史简化为最简单的历史，解释树的最终状态。最简单，因为如果最终结果相同，它将修剪一些侧分支（即合并具有相同内容的分支）

--show-pulls
包括默认模式下的所有提交，还包括不是对第一个父级的TREESAME而是对后一个父级的TREESAME的所有合并提交。此模式有助于显示“首次引入”分支更改的合并提交。

--full-history
与默认模式相同，但不修剪某些历史记录。

--dense
仅显示选定的提交，还有一些具有有意义的历史记录。

--sparse
显示了简化历史记录中的所有提交。

--simplify-merges
–full-history从结果历史记录中删除一些不必要的合并的 附加选项，因为没有选定的提交会对此合并作出贡献。

--ancestry-path
给定要显示的提交范围（例如commit1…commit2 或commit2 ^commit1）时，仅显示直接存在于commit1和 commit2之间的祖先链上的提交，即既是commit1的后代又是commit2的后代的提交。

排序提交

--date-order
日期顺序 在显示所有子项之前不显示任何父母，否则以提交时间戳记顺序显示提交。

--author-date-order
在显示所有子项之前不显示任何父母，否则按作者时间戳顺序显示提交。

--topo-order
在显示所有子项之前，不要显示任何父母，并避免在多个历史记录中混合显示提交。

--reverse
以相反的顺序输出选择显示的提交

格式化提交

--pretty[=]

--format=

以给定的格式漂亮地打印提交日志的内容，
其中可以是oneline，short，medium， full，fuller，reference，email，raw，format： 和 tformat：之一。
如果都不是上述内容，并且其中包含％placeholder，则它的作用就像给出了--pretty = tformat：一样。
如果省略= 部分，则默认为medium。

--abbrev-commit

不要显示完整的40字节十六进制提交对象名称，而是显示一个可以唯一命名对象的前缀。“ --abbrev = ”（如果显示，它也会修改diff输出）选项可用于指定前缀的最小长度。

对于使用80列终端的人来说，这应该使“ --pretty = oneline”更具可读性。

--no-abbrev-commit

显示完整的40字节十六进制提交对象名称。这否定 --abbrev-commit了其他选项（例如“ --oneline”）的显式或隐式。它还会覆盖log.abbrevCommit变量。

--oneline

这是一起使用的--pretty = oneline --abbrev-commit的简写。

--encoding=

提交对象在其编码标头中记录用于日志消息的编码。此选项可用于告诉命令以用户首选的编码方式重新编码提交日志消息。对于非管道命令，默认为UTF-8。

--expand-tabs =

--expand-tabs

--no-expand-tabs

在日志消息中执行选项卡扩展（在每个选项卡中留出足够的空间以填充到下一个显示列，该显示列是的倍数），然后在输出中显示它。 --expand-tabs是的简写形式–expand-tabs=8， --no-expand-tabs也是的简写形式–expand-tabs=0，它禁用制表符扩展。

默认情况下，选项卡以漂亮的格式扩展，该格式将日志消息缩进4个空格

--notes [= ]

在显示提交日志消息时，显示注释提交的注释。

这是默认的git log，git show并且git whatchanged在没有命令--pretty，--format或者--oneline在命令行上给出的选项。

默认情况下，显示的注释来自core.notesRef and notes.displayRef变量中列出的注释参考 （或相应的环境替代）。

可以组合多个–notes选项来控制显示哪些笔记。示例：--notes = foo将仅显示“ refs/notes/foo”中的注释；“ --notes = foo --notes”将同时显示“ refs/notes/foo”中的注释和默认注释ref中的注释。

--no-notes

不要显示注释。–notes通过重置从中显示注释的注释引用列表，可以取消上述选项。选项按命令行给定的顺序进行解析，因此，例如“ --notes --notes = foo --no-notes --notes = bar”将仅显示“ refs/notes/bar”中的注释。

--show-signature

通过将签名传递到gpg --verify并显示输出来检查已签名提交对象的有效性。

--relative-date

--date=relative的同义词.

--date=

仅对以人类可读格式显示的日期生效，例如使用时--pretty。log.dateconfig变量为log命令的--date选项设置默认值。默认情况下，日期显示在原始时区（提交者或作者的时间）中。如果-local将附加到格式（例如iso-local），则使用用户的本地时区。

--date=relative

显示相对于当前时间的日期，例如“ 2小时前”。该-local选项对--date=relative无效 。

--date=local

是--date=default-local的别名。

--date=iso（或--date=iso8601）

以类似于ISO 8601的格式显示时间戳。与严格的ISO 8601格式的区别是：

用空格代替T日期/时间定界符

时区与时区之间的空间

时区的小时和分钟之间没有冒号

--date=iso-strict（或--date=iso8601-strict）

以严格的ISO 8601格式显示时间戳。

--date=rfc（或--date=rfc2822）

以RFC 2822格式显示时间戳，通常在电子邮件中找到。

--date=short

仅以YYYY-MM-DD格式显示日期，而不显示时间。

--date=raw

将日期显示为从纪元（1970-01-01 00:00:00 UTC）开始的秒数，后跟一个空格，然后将时区显示为相对UTC的偏移量（a+或-四位数；前两个是小时，并且后两分钟）。即，好像时间戳记是用格式化的strftime("%s %z")。请注意，该-local选项不会影响秒计时以来的值（始终以UTC度量），但是会切换随附的时区值。

--date=human

如果时区与当前时区不匹配，则显示时区；如果时区不匹配，则不显示整个日期（例如，跳过打印年份为“今年”的日期，但是如果显示时，则跳过整个日期本身）最近几天，我们可以说是星期几。对于较早的日期，还会省略小时和分钟。

--date=unix

将日期显示为Unix纪元时间戳（自1970年以来的秒数）。与一样–raw，这始终是UTC，因此-local 无效。

--date=format:

…将格式提供…给您的系统strftime，但％z和％Z除外，它们在内部处理。用于--date=format:%c以系统区域设置的首选格式显示日期。有关strftime格式占位符的完整列表，请参见手册。使用时-local，正确的语法是 --date=format-local:…。

--date=default

是默认格式，与相似 --date=rfc2822，但有一些例外：

星期几后没有逗号

使用本地时区时，将省略时区

--parents

还打印提交的父母（以“ commit parent…”的形式）。还可以启用父级重写，请参见上面的“历史记录简化”。

--children

还打印提交的子项（格式为“ commit child…”）。还可以启用父级重写，请参见上面的“历史记录简化”。

--left-right

标记可从哪个对称差异到达提交。从左侧提交的前缀为<那些用正确的和>。如果与组合–boundary，则这些提交将以前缀-。

例如，如果您具有以下拓扑：

         y---b---b  branch B
        / \ /
       /   .
      /   / \
     o---x---a---a  branch A

您将获得如下输出：

    $ git rev-list --left-right --boundary --pretty=oneline A...B

    >bbbbbbb... 3rd on b
    >bbbbbbb... 2nd on b
    

--graph

在输出的左侧绘制提交历史的基于文本的图形表示。这可能会导致在两次提交之间打印额外的行，以便正确绘制图形历史记录。不能与结合使用–no-walk。

这样可以进行父级重写，请参见上面的“历史简化”。

这意味着--topo-order默认情况下该选项，但是--date-order也可以指定该选项。

--show-linear-break[=]

当不使用–graph时，所有历史分支均被展平，这使得很难看到两个连续的提交不属于线性分支。在这种情况下，此选项在它们之间设置了障碍。如果指定，则将显示该字符串，而不是默认字符串。

漂亮的打印样式

漂亮的格式
如果提交是合并，并且如果pretty-format格式不是oneline，email或raw，则在Author：行之前插入另一行。该行以“ Merge：”开头，并打印祖先提交的哈希，并用空格分隔。

oneline