限制输出的提交数量。

在开始显示提交输出之前跳过 number 个提交。

显示比特定日期更新的提交。

显示所有比特定日期更新的提交。这会访问范围内的所有提交，而不是在第一个比特定日期旧的提交处停止。

显示比特定日期旧的提交。

将提交输出限制为其作者/提交者标题行与指定模式（正则表达式）匹配的提交。对于多个 --author=<pattern>，选择其作者与任何给定模式匹配的提交（对于多个 --committer=<pattern> 也是如此）。

将提交输出限制为其 reflog 条目与指定模式（正则表达式）匹配的提交。对于多个 --grep-reflog，选择其 reflog 消息与任何给定模式匹配的提交。除非正在使用 --walk-reflogs，否则使用此选项将导致错误。

将提交输出限制为其日志消息与指定模式（正则表达式）匹配的提交。对于多个 --grep=<pattern>，选择其消息与任何给定模式匹配的提交（但请参阅 --all-match）。

将提交输出限制为与所有给定的 --grep 匹配的提交，而不是与至少一个匹配的提交。

将提交输出限制为其日志消息与使用 --grep=<pattern> 指定的模式不匹配的提交。

匹配正则表达式限制模式，不考虑字母大小写。

将限制模式视为基本正则表达式；这是默认值。

将限制模式视为扩展正则表达式，而不是默认的基本正则表达式。

将限制模式视为固定字符串（不要将模式解释为正则表达式）。

将限制模式视为与 Perl 兼容的正则表达式。

当给定路径从树中消失时停止。

仅打印合并提交。这与 --min-parents=2 完全相同。

不要打印具有多个父级的提交。这与 --max-parents=1 完全相同。

仅显示至少（或至多）具有该数量的父级提交的提交。特别是，--max-parents=1 与 --no-merges 相同，--min-parents=2 与 --merges 相同。--max-parents=0 给出所有根提交，--min-parents=3 给出所有章鱼合并。

在查找要包含的提交时，在看到合并提交时仅跟踪第一个父级提交。当查看特定主题分支的演变时，此选项可以提供更好的概述，因为合并到主题分支中往往只是为了不时地调整到更新的上游，此选项允许您忽略通过此类合并引入历史记录的各个提交。

在查找要排除的提交（使用 ^）时，在看到合并提交时仅跟踪第一个父级提交。鉴于任意合并可以是有效的主题分支更改，这可以用于查找主题分支中从其与远程分支分歧点开始的更改集。

反转所有后续修订版本说明符（直到下一个 --not）中 ^ 前缀（或缺少前缀）的含义。当在命令行上在 --stdin 之前使用时，通过 stdin 传递的修订版本不会受其影响。相反，当通过标准输入传递时，命令行上传递的修订版本不会受其影响。

假装 refs/ 中的所有引用以及 HEAD 都在命令行上列出为 <commit>。

假装 refs/heads 中的所有引用都在命令行上列出为 <commit>。如果给出了 <pattern>，则将分支限制为与给定 shell 通配符匹配的分支。如果模式缺少 ?、* 或 [，则隐含 /* 在末尾。

假设refs/tags中的所有引用都作为<commit>列在命令行上。如果给出了<pattern>，则将标签限制为与给定的 shell 通配符匹配的标签。如果模式缺少?、*或[，则隐含末尾的/*。

假设refs/remotes中的所有引用都作为<commit>列在命令行上。如果给出了<pattern>，则将远程跟踪分支限制为与给定的 shell 通配符匹配的分支。如果模式缺少?、*或[，则隐含末尾的/*。

假设所有与 shell 通配符<glob-pattern>匹配的引用都作为<commit>列在命令行上。如果缺少，则会自动在前面添加前导refs/。如果模式缺少?、*或[，则隐含末尾的/*。

不包括与<glob-pattern>匹配的引用，否则下一个--all、--branches、--tags、--remotes或--glob会考虑这些引用。此选项的重复会累积排除模式，直到下一个--all、--branches、--tags、--remotes或--glob选项（其他选项或参数不会清除累积的模式）。

不包括git-fetch、git-receive-pack或git-upload-pack通过参考相应的fetch.hideRefs、receive.hideRefs或uploadpack.hideRefs配置以及transfer.hideRefs（参见git-config[1]）隐藏的引用。此选项会影响下一个伪引用选项--all或--glob，并在处理它们后清除。

假设所有由 reflog 提及的对象都作为<commit>列在命令行上。

假设所有作为备用存储库的引用提示提到的对象都列在命令行上。备用存储库是指其对象目录在objects/info/alternates中指定的任何存储库。包含的对象集可以通过core.alternateRefsCommand等修改。参见git-config[1]。

默认情况下，当有多个工作树时（参见git-worktree[1]），以下选项将检查所有工作树：--all、--reflog和--indexed-objects。此选项强制它们仅检查当前工作树。

在输入中看到无效的对象名称时，假设未给出错误的输入。

假设错误的二分查找引用refs/bisect/bad已列出，并且假设它后面跟着--not和良好的二分查找引用refs/bisect/good-*在命令行上。

除了从命令行获取参数外，还可以从标准输入中读取参数。这接受提交和类似--all和--glob=的伪选项。当看到--分隔符时，以下输入将被视为路径并用于限制结果。通过标准输入读取的--not之类的标志仅在其以相同方式传递的参数中受到尊重，并且不会影响任何后续的命令行参数。

类似于--cherry-pick（见下文），但用=标记等效提交，而不是省略它们，用+标记不等效提交。

当使用对称差集限制提交集时，省略任何引入与“另一侧”上的另一个提交相同更改的提交。

仅列出对称差集各自侧面的提交，即仅列出--left-right将标记为<或>的提交。

--right-only --cherry-mark --no-merges的同义词；用于将输出限制在我们这一侧的提交，并标记已应用于分叉历史记录另一侧的那些提交，使用git log --cherry upstream...mybranch，类似于git cherry upstream mybranch。

不是遍历提交祖先链，而是从最新的 reflog 条目遍历到旧的条目。使用此选项时，您不能指定要排除的提交（即，不能使用^commit、commit1..commit2和commit1...commit2表示法）。

显示在范围HEAD...<other>中触及冲突路径的提交，其中<other>是MERGE_HEAD、CHERRY_PICK_HEAD、REVERT_HEAD或REBASE_HEAD中第一个存在的伪引用。仅当索引具有未合并的条目时才有效。此选项可用于在解决来自三方合并的冲突时显示相关提交。

输出排除的边界提交。边界提交以-作为前缀。

选择修改给定<paths>的提交。

选择某些分支或标签引用的提交。

将历史记录简化为解释树最终状态的最简单历史记录。最简单，因为它会在最终结果相同的情况下修剪一些分支（即合并具有相同内容的分支）

包括默认模式中的所有提交，以及任何对第一个父级不是 TREESAME 但对以后的父级是 TREESAME 的合并提交。此模式有助于显示“首次引入”分支更改的合并提交。

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

仅显示选定的提交，以及一些用于提供有意义的历史记录的提交。

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

--full-history的附加选项，用于从结果历史记录中删除一些不必要的合并，因为没有选定的提交有助于此合并。

当给定一个要显示的提交范围（例如commit1..commit2或commit2 ^commit1）时，仅显示该范围内属于<commit>的祖先、<commit>的后代或<commit>本身的提交。如果未指定提交，则使用commit1（范围的排除部分）作为<commit>。可以多次传递；如果是这样，如果提交是给定的任何提交，或者它是其中一个提交的祖先或后代，则包含该提交。

如果提交对任何父级都不是TREESAME，则包含该提交（尽管这可以更改，请参阅下面的--sparse）。如果提交是合并提交，并且对一个父级是TREESAME，则仅跟踪该父级。（即使有多个TREESAME父级，也只跟踪其中一个。）否则，跟踪所有父级。

	  .-A---N---O
	 /     /   /
	I---------D

此模式与默认模式在一个点上有所不同：始终跟踪合并的所有父级，即使它对其中一个父级是TREESAME。即使合并的多个方面都有包含的提交，这也不意味着合并本身是!在示例中，我们得到

	I  A  B  N  D  O  P  Q

仅当普通提交为!TREESAME时才包含（尽管这可以更改，请参阅下面的--sparse）。

	  .-A---M---N---O---P---Q
	 /     /   /   /   /
	I     B   /   D   /
	 \   /   /   /   /
	  `-------------'

如果遍历的提交对任何父级都不是TREESAME，则包含该提交。

包含所有遍历的提交。

首先，以与带父级重写的--full-history相同的方式构建历史图（请参见上文）。

	  .-A---M---N---O
	 /     /       /
	I     B       D
	 \   /       /
	  `---------'

将显示的提交限制为<commit>的祖先、<commit>的后代或<commit>本身。

	    D---E-------F
	   /     \       \
	  B---C---G---H---I---J
	 /                     \
	A-------K---------------L--M

		E-------F
		 \       \
		  G---H---I---J
			       \
				L--M

		E
		 \
		  G---H---I---J
			       \
				L--M

		K---------------L--M

除了在默认历史记录中显示的提交之外，还显示每个不与第一个父级TREESAME但与后续父级TREESAME的合并提交。

	I---X---R---N

	  .-A---M--.   N
	 /     /    \ /
	I     B      R
	 \   /      /
	  \ /      /
	   `---X--'

在所有子节点显示之前不显示父节点，但在其他情况下按提交时间戳顺序显示提交。

在所有子节点显示之前不显示父节点，但在其他情况下按作者时间戳顺序显示提交。

在所有子节点显示之前不显示父节点，并避免在历史记录的多条线上显示混合的提交。

    ---1----2----4----7
	\	       \
	 3----5----6----8---

以相反的顺序输出选择显示的提交（请参阅上面的“提交限制”部分）。不能与--walk-reflogs组合使用。

仅显示给定的提交，但不遍历其祖先。如果指定了范围，则此选项无效。如果给出了参数unsorted，则提交将按命令行上给出的顺序显示。否则（如果给出了sorted或未给出参数），则提交将按提交时间以逆时间顺序显示。不能与--graph组合使用。

覆盖之前的--no-walk。

以给定格式漂亮打印提交日志的内容，其中<format>可以是oneline、short、medium、full、fuller、reference、email、raw、format:<string>和tformat:<string>之一。当<format>不是上述任何一种，并且其中包含%placeholder时，它的行为就像给出了--pretty=tformat:<format>一样。

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

显示完整的 40 字节十六进制提交对象名称。这会否定--abbrev-commit，无论是显式还是由其他选项（如 "--oneline"）隐式指定。它还会覆盖log.abbrevCommit变量。

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

提交对象在其编码头中记录用于日志消息的字符编码；此选项可用于告诉命令以用户首选的编码重新编码提交日志消息。对于非管道命令，默认为 UTF-8。请注意，如果某个对象声称以X编码，而我们正在以X输出，我们将逐字输出该对象；这意味着原始提交中的无效序列可能会复制到输出中。同样，如果 iconv(3) 无法转换提交，我们将静默地逐字输出原始对象。

在日志消息中执行制表符扩展（将每个制表符替换为足够的空格以填充到下一个显示列，该列是<n>的倍数），然后在输出中显示它。--expand-tabs是--expand-tabs=8的简写形式，--no-expand-tabs是--expand-tabs=0的简写形式，它禁用制表符扩展。

显示注释提交的注释（请参阅git-notes[1]），当显示提交日志消息时。当命令行上没有给出--pretty、--format或--oneline选项时，这是git log、git show和git whatchanged命令的默认设置。

不显示注释。这会通过重置显示注释的注释 ref 列表来否定上面的--notes选项。选项按命令行上给出的顺序解析，因此例如 "--notes --notes=foo --no-notes --notes=bar" 将仅显示来自"refs/notes/bar"的注释。

除非给出了显示特定注释的选项，否则显示默认注释。

这些选项已弃用。请改用上述 --notes/--no-notes 选项。

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

--date=relative的同义词。

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

还打印提交的父提交（格式为“commit parent…”）。还启用父重写，请参阅上面的“历史简化”。

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

标记提交可以从哪个对称差异的一侧到达。左侧的提交以<为前缀，右侧的提交以>为前缀。如果与--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
	<aaaaaaa... 3rd on a
	<aaaaaaa... 2nd on a
	-yyyyyyy... 1st on b
	-xxxxxxx... 1st on a

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

当不使用 --graph 时，所有历史分支都被展平，这可能难以看出两个连续的提交不属于线性分支。在这种情况下，此选项会在它们之间放置一个屏障。如果指定了<barrier>，则它将是显示的字符串，而不是默认字符串。