将输出限制为 <number> 个提交。

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

显示比 <date> 更新的提交。

显示所有比 <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）仅对以相同方式传递的参数有效，并且不会影响任何后续命令行参数。

不要向标准输出打印任何内容。此形式主要用于允许调用者测试退出状态，以查看对象范围是否完全连接（或不）。它比将 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 中的第一个存在的伪引用。仅当索引包含未合并条目时才有效。此选项可用于在解决 3 路合并冲突时显示相关提交。

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

尝试使用 pack bitmap 索引（如果可用）来加速遍历。请注意，在使用 --objects 进行遍历时，树和 blob 的关联路径将不会被打印。

在考虑对象时，在 stderr 上显示进度报告。 <header> 文本将随每次进度更新一起打印。

输出的每个对象及其附带的元数据将使用 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 求值。这些行将中间修订版的名称赋给变量 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] 使用来构建“瘦” pack，它以增量形式记录对象，基于这些排除提交中的对象，以减少网络流量。

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

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

仅与 --objects 有效；打印不在 pack 中的对象 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` 的简写。

提交对象在它们的 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`），则改为使用用户的本地时区。

以原始格式打印提交内容；每个记录都以 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 一起使用时，则从这些计数中省略补丁等价提交，并用制表符分隔等价提交的数量。