限制输出的提交数量。

在开始显示提交输出之前跳过 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 之前使用时，通过标准输入传递的修订版本不会受其影响。相反，当通过标准输入传递时，命令行中传递的修订版本不会受其影响。

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

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

假装 refs/tags 中的所有引用都以 <commit> 的形式在命令行中列出。如果给出 <pattern>，则将标签限制为匹配给定 shell glob 的标签。如果模式缺少 ?、* 或 [，则隐含在末尾添加 /*。

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

假装所有匹配 shell glob <glob-pattern> 的引用都以 <commit> 的形式在命令行中列出。如果缺少前导 refs/，则会自动添加。如果模式缺少 ?、* 或 [，则隐含在末尾添加 /*。

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

根据适当的 fetch.hideRefs、receive.hideRefs 或 uploadpack.hideRefs 配置以及 transfer.hideRefs（参见 git-config[1]），不包含会被 git-fetch、git-receive-pack 或 git-upload-pack 隐藏的引用。此选项影响下一个伪引用选项 --all 或 --glob，并在处理后清除。

假装引用日志中提及的所有对象都作为 <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> 的后代或 <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
		 \
	      C---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>" 选项（如果显示差异输出，此选项也会对其进行修改）来指定前缀的最小长度。

显示完整的 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 命令的默认行为。

不显示附注。这通过重置显示附注的附注引用列表来抵消上述 --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>，它将是代替默认字符串显示的字符串。