限制输出的提交数量。

在开始显示提交输出之前跳过 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。此选项强制它们仅检查当前工作树。

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

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

不要向标准输出打印任何内容。此表单主要用于允许调用者测试退出状态以查看一系列对象是否完全连接（或未连接）。它比将 stdout 重定向到 /dev/null 更快，因为输出不需要进行格式化。

抑制正常输出；而是打印所选提交或对象在磁盘上存储使用的字节数之和。这等同于将输出通过管道传递给 git cat-file --batch-check='%(objectsize:disk)'，但运行速度快得多（尤其是在使用 --use-bitmap-index 时）。有关“磁盘存储”的含义的限制，请参阅 git-cat-file[1] 中的 CAVEATS 部分。使用可选值 human，磁盘存储大小将以人类可读的字符串显示（例如 12.24 Kib、3.50 Mib）。

类似于 --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 中第一个存在的伪引用。仅在索引具有未合并的条目时才有效。此选项可用于在解决来自三方合并的冲突时显示相关提交。

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

尝试使用包位图索引（如果可用）加快遍历速度。请注意，当使用 --objects 遍历时，树和 blob 不会打印其关联的路径。

在考虑对象时在 stderr 上显示进度报告。每次进度更新时都会打印 <header> 文本。

选择修改给定<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--'

将输出限制为大致位于包含的提交和排除的提交之间的中间的单个提交对象。请注意，错误的二分查找引用 refs/bisect/bad 会被添加到包含的提交中（如果存在），而良好的二分查找引用 refs/bisect/good-* 会被添加到排除的提交中（如果存在）。因此，假设 refs/bisect/ 中没有引用，如果

	$ git rev-list --bisect foo ^bar ^baz

	$ git rev-list foo ^midpoint
	$ git rev-list midpoint ^bar ^baz

此选项计算的结果与 --bisect 相同，但它不使用 refs/bisect/ 中的引用，并且输出的文本可以由 shell 进行 eval。这些行将中间修订版的名称赋值给变量 bisect_rev，测试 bisect_rev 后预计要测试的提交数量赋值给 bisect_nr，如果 bisect_rev 证明是好的，则预计要测试的提交数量赋值给 bisect_good，如果 bisect_rev 证明是不好的，则预计要测试的提交数量赋值给 bisect_bad，以及我们现在正在进行二分查找的提交数量赋值给 bisect_all。

此选项输出包含的提交和排除的提交之间的所有提交对象，并按它们到包含的提交和排除的提交的距离排序。它不使用 refs/bisect/ 中的引用。距离最远的提交首先显示。（这是 --bisect 唯一显示的提交。）

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

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

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

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

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

打印列出的提交引用的任何对象的对象 ID。因此，--objects foo ^bar 表示“如果我有提交对象 bar 但没有 foo，请发送我需要下载的所有对象 ID”。另请参阅下面的 --object-names。

按提交顺序打印树和 Blob ID。树和 Blob ID 在它们第一次被提交引用后打印。

类似于 --objects，但还会打印以“ - ”字符为前缀的排除提交的 ID。这被 git-pack-objects[1] 用于构建“瘦”包，该包基于这些排除提交中包含的对象以增量形式记录对象，以减少网络流量。

类似于 --objects-edge，但它会更加努力地查找排除的提交，代价是增加了时间。这用于代替 --objects-edge 为浅层仓库构建“瘦”包。

假装索引使用的所有树和 Blob 都在命令行上列出。请注意，您可能也需要使用 --objects。

仅在 --objects 中有用；打印不在包中的对象 ID。

仅在 --objects 中有用；打印找到的对象 ID 的名称。这是默认行为。请注意，每个对象的“名称”是模棱两可的，主要作为打包对象的提示。特别是：标签、树和 Blob 的名称之间没有区别；路径名可能会被修改以删除换行符；如果一个对象以不同的名称多次出现，则只显示一个名称。

仅在 --objects 中有用；不打印找到的对象 ID 的名称。这反转了 --object-names。此标志允许输出更容易地被诸如 git-cat-file[1] 之类的命令解析。

仅在 --objects* 中的一个中有用；从打印的对象列表中省略对象（通常是 Blob）。<filter-spec> 可以是以下之一：

关闭任何先前的--filter=参数。

过滤显式提供的对象列表，否则即使它们与任何过滤器都不匹配，这些对象也会始终被打印。仅在使用--filter=时有用。

仅在使用--filter=时有用；打印过滤器省略的对象列表。对象 ID 前缀为“~”字符。

一个调试选项，用于帮助未来的“部分克隆”开发。此选项指定如何处理缺失的对象。

（仅供内部使用。）在承诺者边界处预先过滤对象遍历。这与部分克隆一起使用。这比--missing=allow-promisor更强大，因为它限制了遍历，而不仅仅是使有关缺失对象的错误静音。

仅显示给定的提交，但不遍历其祖先。如果指定了范围，则此操作无效。如果给出了参数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的简写，它禁用制表符扩展。

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

--date=relative的同义词。

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

以原始格式打印提交内容；每个记录之间用 NUL 字符分隔。

抑制包含“commit”和在指定格式之前打印的对象 ID 的标题行。这对内置格式没有影响；只有自定义格式受到影响。

覆盖之前的 --no-commit-header。

还打印提交的父提交（以“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>，则它将是显示的字符串，而不是默认字符串。

打印一个数字，说明将列出多少个提交，并抑制所有其他输出。当与 --left-right 结合使用时，改为打印左右提交的计数，并用制表符分隔。当与 --cherry-mark 结合使用时，从这些计数中省略补丁等效提交，并打印等效提交的计数，并用制表符分隔。