限制要输出的提交数量。

跳过 *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 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 选项（其他选项或参数不会清除累积的模式）。

不要包含会被 git-fetch、git-receive-pack 或 git-upload-pack 隐藏的引用，方法是查阅相应的 fetch.hideRefs、receive.hideRefs 或 uploadpack.hideRefs 配置以及 transfer.hideRefs（请参阅 git-config[1]）。此选项会影响下一个伪引用选项 --all 或 --glob，并在处理完它们后清除。

假装 reflog 中提到的所有对象都作为 <commit> 在命令行中列出。

假装作为备用存储库的 ref 提示提到的所有对象都在命令行中列出。备用存储库是指其对象目录在 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 中第一个现有的伪引用。仅当索引具有未合并的条目时才有效。此选项可用于在解决 3 向合并中的冲突时显示相关提交。

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

选择修改给定 <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
		 \
		  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”一起使用的简写形式。

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

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

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

不显示注释。 这会否定上面的 --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>，它将是显示的字符串，而不是默认字符串。