限制要输出的提交对象数量。

在开始显示提交对象输出之前跳过 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 给出所有章鱼合并。

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

当查找要排除的提交（带有^）时，遇到合并提交时，仅跟踪第一个父提交。当任意合并是有效的Topic Branch更改时，这可以用于查找Topic Branch中与远程分支分离时的更改集。

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

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

假装refs/heads中的所有引用都作为<commit>在命令行上列出。如果给出了<pattern>，则将分支限制为与给定的Shell Glob匹配的分支。如果Pattern缺少?，*或[，则暗示末尾的/*。

假装refs/tags中的所有引用都作为<commit>在命令行上列出。如果给出了<pattern>，则将标签限制为与给定的Shell Glob匹配的标签。如果Pattern缺少?，*或[，则暗示末尾的/*。

假装refs/remotes中的所有引用都作为<commit>在命令行上列出。如果给出了<pattern>，则将远程跟踪分支限制为与给定的Shell Glob匹配的分支。如果Pattern缺少?，*或[，则暗示末尾的/*。

假装与Shell Glob <glob-pattern> 匹配的所有引用都作为 <commit> 在命令行上列出。 如果缺少前导的 refs/，则会自动添加。如果 Pattern 缺少 ?, *, 或 [，则暗示末尾的 /*。

不要包含与 <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。此选项强制它们仅检查当前工作树。

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

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

不要将任何内容打印到标准输出。此形式主要用于允许调用方测试退出状态，以查看某个对象范围是否完全连接（或未连接）。这比将标准输出重定向到 /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 条目到较旧的条目，遍历 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> 的后代或 <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] 用来构建“thin”包，它基于这些排除的提交中包含的对象以 delta 形式记录对象，以减少网络流量。

类似于 --objects-edge，但它会花费更多时间来查找排除的提交。这用于代替 --objects-edge 来为浅层存储库构建“thin”包。

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

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

仅在使用 --objects 时有用；打印找到的对象 ID 的名称。这是默认行为。请注意，每个对象的“名称”都是含糊不清的，主要用作打包对象的提示。特别是：不区分标签、树和 blob 的名称；路径名可能会被修改以删除换行符；并且如果一个对象使用不同的名称多次出现，则仅显示一个名称。

仅在使用 --objects 时有用；不打印找到的对象 ID 的名称。这会反转 --object-names。此标志允许命令（例如 git-cat-file[1]）更容易地解析输出。

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

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

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

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

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

（仅供内部使用。）在 promisor 边界处预过滤对象遍历。这与部分克隆一起使用。这比 --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），则改为使用用户的本地时区。

以原始格式打印提交的内容；每个记录都用空字符分隔。

禁止在指定格式之前打印的包含“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 一起使用时，从这些计数中省略补丁等效提交，并打印等效提交的计数，以制表符分隔。