将输出限制为 <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 路合并冲突时显示相关提交。

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

尝试使用包位图索引（如果可用）来加速遍历。请注意，在使用 --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 结果是好的，预期要测试的提交数量赋值给 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。

按提交顺序打印树和数据对象的 ID。树和数据对象 ID 在它们第一次被提交引用后打印。

类似于 --objects，但也打印带有“-”前缀的排除提交的 ID。这被 git-pack-objects[1] 用于构建“瘦”包（thin pack），该包根据这些排除提交中包含的对象以差分形式记录对象，以减少网络流量。

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

假装索引所使用的所有树和数据对象都列在命令行中。请注意，你可能也想使用 --objects。

仅在与 --objects 配合使用时有效；打印不在包文件中的对象 ID。

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

仅在与 --objects 配合使用时有效；不打印找到的对象 ID 的名称。这会反转 --object-names 的行为。此标志允许输出更容易被 git-cat-file[1] 等命令解析。

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

关闭之前任何 --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`），则改为使用用户的本地时区。

以原始格式（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>，则它将是显示而不是默认字符串。

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