限制仅输出将要显示的前 <数字> 个提交。

限制仅输出将要显示的最后 <数字> 个提交。

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

显示比 <日期> 更近的提交。作为一个特殊情况，today 表示刚刚过去的午夜。

显示所有比 <date> 更新的提交。这会遍历范围内的所有提交，而不是在第一个比 <date> 旧的提交处停止。

显示比 <date> 旧的提交。

限制仅输出指定时间范围内的提交。

将提交输出限制为作者/提交者标题行与 <pattern> 正则表达式匹配的提交。使用多个 --author=<pattern> 时，会选择作者匹配任何 <pattern> 的提交（对多个 --committer=<pattern> 类似）。

将提交输出限制为 reflog 条目与 <pattern> 正则表达式匹配的提交。使用多个 --grep-reflog 时，会选择 reflog 消息匹配任何给定模式的提交。使用此选项但未同时使用 --walk-reflogs 是错误的。

将提交输出限制为其日志消息匹配 <pattern> 正则表达式的提交。使用多个 --grep=<pattern> 时，会选择消息匹配任何 <pattern> 的提交（但请参阅 --all-match）。

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

将提交输出限制为其日志消息不匹配使用 --grep=<pattern> 指定的 <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 匹配的分支。如果 <pattern> 缺少 ?、* 或 [，则在末尾隐含 /*。

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

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

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

不包括与下一个 --all、--branches、--tags、--remotes 或 --glob 将要考虑的 <glob-pattern> 匹配的引用。此选项的重复使用会累积排除模式，直到下一个 --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，并在处理它们之后清除。

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

假装备用存储库的引用尖端中提到的所有对象都已在命令行上列出。备用存储库是其对象目录在 objects/info/alternates 中指定的任何存储库。包含的对象集可能由 core.alternateRefsCommand 等修改。请参阅 git-config[1]。

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

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

除了从命令行获取参数外，还可以从标准输入读取它们。这接受提交和伪选项，如 --all 和 --glob=。当看到 -- 分隔符时，后面的输入被视为路径并用于限制结果。通过 stdin 读取的标志（如 --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 条目。使用此选项时，您不能指定要排除的提交（即，不能使用 ^<commit>、<commit1>..<commit2> 和 <commit1>...<commit2> 表示法）。

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

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

尝试使用包位图索引（如果可用）来加速遍历。请注意，在使用 --objects 遍历时，树（tree）和数据对象（blob）将不会打印与其关联的路径。

在处理对象时，在标准错误（stderr）中显示进度报告。每次更新进度时，都会打印 <标头> 文本。

每个输出的对象及其伴随的元数据不再以换行符分隔，而是使用空字节（NUL）分隔。输出以下列形式打印

<OID> NUL [<token>=<value> NUL]...

<OID> NUL
<OID> NUL path=<path> NUL
<OID> NUL boundary=yes NUL
<OID> NUL missing=yes NUL [<token>=<value> NUL]...

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

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

将历史简化为解释树最终状态的最简单历史。之所以最简单，是因为如果最终结果相同（即合并内容相同的分支），它会修剪一些旁支。

包含默认模式中的所有提交，但也包括任何与第一个父提交不 TREESAME 但与较晚的父提交 TREESAME 的合并提交。此模式有助于显示“首次引入”更改到分支的合并提交。

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

只显示选定的提交，以及一些具有有意义历史的提交。

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

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

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

包含的提交是那些与任何父项都不同的提交（尽管这可以改变，请参见下文的 --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--'

限制仅输出一个提交对象，该对象大致位于包含的和排除的提交之间的中间位置。注意，坏的二分引用 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 测试结果为好（good）时预期要测试的提交数量赋值给 bisect_good，将如果 bisect_rev 测试结果为坏（bad）时预期要测试的提交数量赋值给 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。

按提交顺序打印树（tree）和数据对象（blob）的 ID。树和数据对象的 ID 会在它们被提交首次引用后打印。

类似于 --objects，但还会打印排除的提交的 ID，并带有前缀“-”字符。这被 git-pack-objects[1] 用于构建“瘦”包（thin pack），该包基于这些排除的提交中包含的对象，以差异化（deltified）形式记录对象，从而减少网络流量。

类似于 --objects-edge，但它会以增加时间为代价更努力地寻找排除的提交。这用于代替 --objects-edge 来为浅克隆（shallow）仓库构建“瘦”包。

假装索引使用的所有树（tree）和数据对象（blob）都列在了命令行上。请注意，你可能还需要使用 --objects。

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

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

仅对 --objects 有用；不打印找到的对象 ID 的名称。这与 --object-names 相反。此标志使输出更容易被诸如 git-cat-file[1] 等命令解析。

仅与 --objects* 之一结合使用时有用；在打印的对象列表中省略某些对象（通常是数据对象）。<过滤器规范> 可以是以下之一

关闭之前所有的 --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` 的简写。

提交对象在它们的 encoding 头中记录了日志消息使用的字符编码；此选项可用于告诉命令将提交日志消息重新编码为用户首选的编码。对于非底层命令，默认为 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` 配置变量为 `git log` 命令的 `--date` 选项设置默认值。默认情况下，日期显示在原始时区（提交者或作者的）。如果将 `-local` 追加到格式（例如，`iso-local`），则改为使用用户的本地时区。

以原始格式（raw-format）打印提交的内容；每条记录用空字符（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>，则它将是显示而不是默认字符串。

使用 --graph 时，限制显示的图形通道数量。超出限制的通道将替换为截断标记 ~。默认情况下，它设置为 0（无限制），零值和负值将被忽略并视为无限制。

打印一个数字，表示将列出多少个提交，并抑制所有其他输出。当与 --left-right 一起使用时，则打印左侧和右侧提交的数量，用制表符（tab）分隔。当与 --cherry-mark 一起使用时，从这些计数中省略等效补丁的提交，并打印由制表符分隔的等效提交的数量。