限制输出的提交数量。

在开始显示提交输出之前，跳过’数’的提交。

显示比某一特定日期更近的提交。

显示所有比指定日期更近的提交。这将访问该范围内的所有提交，而不是停在第一个比指定日期更早的提交。

显示超过特定日期的提交。

将提交文件的输出限制在作者/提交人标题行符合指定模式（正则表达式）的文件。 如果有多个`--author=<pattern>，则会选择作者符合任何一个给定模式的提交（对于多个--committer=<pattern>`也是如此）。

将提交文件的输出限制在有符合指定模式（正则表达式）的reflog条目的提交文件。如果有多个 --grep-reflog，则会选择那些 reflog 信息符合任何指定模式的提交。 除非使用了`--walk-reflogs`，否则使用此选项是错误的。

将提交结果限制在日志信息与指定模式（正则表达式）相匹配的提交。 如果有多个 --grep=<模式>，则会选择那些日志信息与任何指定模式相匹配的提交（但见 --all-match）。

将输出的提交限制在符合所有给定`--grep`的提交，而不是至少符合一个的提交。

限定输出的提交信息与 `--grep=<模式>`指定的模式不匹配。

匹配正则表达式的限制模式，不考虑字母大小写。

将限制性模式视为基本的正则表达式；这是默认的。

将限制性模式视为扩展的正则表达式，而不是默认的基本正则表达式。

将限制性模式视为固定字符串（不要将模式解释为正则表达式）。

将限制性模式视为与Perl兼容的正则表达式。

当一个给定的路径从树上消失时停止。

只打印合并后的提交。这与`--min-parents=2`完全相同。

不打印有一个以上父级的提交。这与`--max-parents=1`完全相同。

只显示至少（或最多）有那么多父提交的提交。特别是，--max-parents=1`等同于--no-merges`，--min-parents=2`等同于--merges`。 --max-parents=0`给出所有根提交，--min-parents=3`给出所有章鱼合并。

查找要包含的提交时，在看到合并提交时只跟随第一个父提交。 在查看某个特性分支的演变时，该选项可以提供更好的概览，因为合并到特性分支往往只是为了不时地适应上游的更新，而该选项可以让你忽略由合并带来的历史中的单个提交。

在寻找要排除的提交（用'^'）时，在看到合并提交时只跟随第一个父提交。 考虑到任意的合并都可以成为有效的主题分支变化，这可以用来查找主题分支中从它与远程分支的分歧点开始的变化集合。

反转 ^ 前缀（或无前缀）对后面所有版本说明符的意义，直到下一个 --not。 在 --stdin 之前的命令行中使用时，通过标准输入流传递的修订版本不会受其影响。反之，通过标准输入传递时，命令行上传递的修订版本也不会受其影响。

假设`refs/‘中的所有参考文献，连同`HEAD`一起，在命令行中被列为’<commit>'。

假设`refs/heads`中的所有 refs 在命令行中被列为 <commit>。如果给出了'<pattern>'，将分支限制在与给定的shell glob相匹配的分支。如果pattern缺少'?、*'或'[，则末尾的/*'是暗示的。

假设`refs/tags`中的所有参考文献在命令行中被列为'<commit>'。如果给出了'<pattern>'，将标签限制在与给定的shell glob相匹配的标签。如果pattern缺少'?、*'或'[，则暗示最后的/*'。

假设`refs/remotes`中的所有 refs 在命令行中被列为 <commit>。如果给出了'<pattern>'，将远程跟踪分支限制在与给定的shell glob相匹配的分支。 如果pattern缺少'?、*'或'[，则末尾的/*'是暗示的。

假设所有与shell glob <glob-pattern>相匹配的refs在命令行中被列为<commit>'。前面的’refs/，如果缺少的话会自动预加。如果模式中缺少?、*'或'[，则在结尾处隐含/*'。

不包括匹配"<glob-pattern>"的参考文献，否则下一个`--all`、--branches、--tags、--remotes`或--glob`会考虑这些参考文献。重复这个选项可以累积排除模式，直到下一个`----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，并在处理后清除。

假设reflogs提到的所有对象都在命令行中被列为`<commit>`。

假设所有提到的作为备用仓库的参考提示的对象都列在命令行上。备用资源库是任何资源库，其对象目录在`objects/info/alternates`中指定。 包含的对象集可以通过`core.alternateRefsCommand`等修改。见git-config[1]。

默认情况下，当有多个工作树时，所有工作树都会被以下选项检查（见git-worktree[1]）：--all，--reflog`和--indexed-objects`。 这个选项强制它们只检查当前的工作树。

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

假设坏的二分法参考文献`refs/bisect/bad`被列出，并且在命令行中假设它后面是`--not`和好的二分法参考文献`refs/bisect/good-*`。

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

就像`--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...<其他> 中触及冲突路径的提交，其中 <其他> 是 MERGE_HEAD、CHERRY_PICK_HEAD、REVERT_HEAD 或 REBASE_HEAD 中第一个存在的伪引用。仅在索引中有未合并条目时有效。这个选项可以在解决三向合并中的冲突时用来显示相关的提交。

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

修改给定<路径>的提交会被选中。

被某个分支或标签引用的提交被选中。

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

包括默认模式下的所有提交，但也包括任何与第一个父分支不相干但与后来的父分支相干的合并提交。这种模式有助于显示 "首次引入 "某个分支的合并提交。

与默认模式相同，但不修剪一些历史记录。

只显示所选的提交，再加上一些才有意义的历史。

简化历史中的所有提交都会显示出来。

为`--full-history`增加了一个选项，可以从结果的历史中删除一些不必要的合并，因为没有选定的提交对这次合并有贡献。

When given a range of commits to display (e.g. commit1..commit2 or commit2 ^commit1), and a commit <commit> in that range, only display commits in that range that are ancestors of <commit>, descendants of <commit>, or <commit> itself. If no commit is specified, use commit1 (the excluded part of the range) as <commit>. Can be passed multiple times; if so, a commit is included if it is any of the commits given or if it is an ancestor or descendant of one of them.

如果提交的内容与任何父类不相干，则被包括在内（当然这一点可以改变，见下面的`--sparse`）。 如果该提交是一个合并，并且它与一个父类是同源的，则只跟随该父类。 (即使有几个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
	 \   /       /
	  `---------'

将显示的提交限制在<提交>的祖先，或<提交>的后代，或<提交>本身。

	    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

除了在默认历史中显示的提交之外，还要显示每一个与第一个父本不相同但与后来的父本相同的合并提交。

	I---X---R---N

	  .-A---M--.   N
	 /     /    \ /
	I     B      R
	 \   /      /
	  \ /      /
	   `---X--'

在显示所有子代之前不显示父代，否则按提交时间戳顺序显示提交。

在显示所有子代之前不显示父代，否则按作者时间戳顺序显示提交。

在显示所有子代之前不显示父代，并避免显示多行历史交错的提交。

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

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

只显示给定的提交，但不遍历其祖先。 如果指定了范围，这一点就没有影响。如果给了参数 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 的简写，它禁止标签扩展。

在显示提交日志信息时，显示注释提交的说明（见git-notes[1]）。 这是`git log`、git show`和`git whatchanged`命令的默认设置，当命令行中没有给出--pretty`、--format`或--oneline`选项时。

不显示注释。这否定了上面的`--notes`选项，因为它重新设置了显示注释的注释列表。 选项按照命令行给出的顺序进行解析，因此，例如"--notes --notes=foo --no-notes --notes=bar "将只显示来自 "refs/notes/bar "的注释。

显示默认备注，除非给出了显示特定备注的选项。

这些选项已被废弃。请使用上面的 --notes/--no-notes 选项来代替。

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

`--date=relative`的同义词。

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

也可以打印提交的父类（以 "提交父类…​ "的形式）。 也可以启用父级改写，见上面的 "历史简化"。

同时打印提交的子项（以 "提交子项…​ "的形式）。 也可以启用父级改写，见上面的 "历史简化"。

标明提交可以从对称性差异的哪一边到达。 左边的提交以 < 为前缀，右边的则以 > 为前缀。 如果与 --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>"，就会显示这个字符串，而不是默认的。