继续列出文件重命名后的历史记录（仅对单个文件有效）。

打印出任何显示提交的引用名称。可能的值为

`short`;; the ref name prefixes `refs/heads/`, `refs/tags/` and
	`refs/remotes/` are not printed.
`full`;; the full ref name (including prefix) is printed.
`auto`:: if the output is going to a terminal, the ref names
	are shown as if `short` were given, otherwise no ref names are
	shown.

对于每个候选引用，如果它与 --decorate-refs-exclude 给出的任何 <pattern> 参数匹配，或者如果它不与 --decorate-refs 给出的任何 <pattern> 参数匹配，则不使用它进行装饰。 log.excludeDecoration 配置选项允许排除用于装饰的引用，但显式的 --decorate-refs 模式将覆盖 log.excludeDecoration 中的匹配项。

指定此选项时，它将清除所有先前的 --decorate-refs 或 --decorate-refs-exclude 选项，并将默认装饰过滤器放宽为包含所有引用。如果配置值 log.initialDecorationSet 设置为 all，则假定此选项。

打印出通过该命令给出的引用名称，每个提交都是通过该引用名称到达的。

使用 mailmap 文件将作者和提交者姓名及电子邮件地址映射到规范的真实姓名和电子邮件地址。请参阅 git-shortlog[1]。

如果不使用此标志，git log -p <path>... 会显示接触指定路径的提交，并显示有关相同指定路径的 diff。使用此选项时，将显示接触指定路径的提交的完整 diff；这意味着 "<path>..." 仅限制提交，而不限制这些提交的 diff。

对于每个提交，在输出中包含一行 log size <number>，其中 <number> 是该提交的消息长度（以字节为单位）。目的是通过允许读取 git log 输出的工具提前分配空间来加快其速度。

跟踪 <file> 中由 <start>,<end> 指定的行范围，或由函数名正则表达式 <funcname> 指定的行范围的演变。您不能给出任何路径名限制器。目前这仅限于从单个修订版开始的遍历，即，您只能给出零个或一个正修订版参数，并且 <start> 和 <end>（或 <funcname>）必须存在于起始修订版中。您可以多次指定此选项。隐含 --patch。可以使用 --no-patch 抑制补丁输出，但其他 diff 格式（即 --raw、--numstat、--shortstat、--dirstat、--summary、--name-only、--name-status、--check）目前未实现。

仅显示指定修订范围内的提交。当未指定 <revision-range> 时，它默认为 HEAD（即指向当前提交的整个历史记录）。origin..HEAD 指定从当前提交（即 HEAD）可到达但不能从 origin 到达的所有提交。有关指定 <revision-range> 的完整列表，请参阅 gitrevisions[7] 中的 "指定范围" 部分。

仅显示足以解释匹配指定路径的文件如何生成的提交。有关详细信息和其他简化模式，请参阅下面的 "历史简化"。

生成补丁（参见 使用 -p 生成补丁文本）。

禁止 diff 引擎的所有输出。这对于像 git show 这样默认显示 patch 的命令很有用，可以抑制其输出，或者取消命令行中别名（alias）中像 --patch、--stat 等选项的影响。

以默认格式显示合并提交的 diff。这类似于 --diff-merges=on，但 -m 除非同时给出了 -p，否则不会产生任何输出。

为合并提交生成组合 diff 输出。--diff-merges=combined -p 的快捷方式。

为合并提交生成密集组合 diff 输出。--diff-merges=dense-combined -p 的快捷方式。

相对于第一个父提交显示合并提交和常规提交的 diff。--diff-merges=first-parent -p 的快捷方式。

为合并提交生成 remerge-diff 输出。--diff-merges=remerge -p 的快捷方式。

--diff-merges=off 的同义词。

指定用于合并提交的 diff 格式。默认是 `off`，除非使用了 `--first-parent`，在这种情况下，`first-parent` 是默认值。

使组合 diff（用于合并提交）列出所有父提交的文件名。因此，它仅在使用了 --diff-merges=[dense-]combined 时才有效，并且只有在检测到文件名更改时（即，当请求了重命名或复制检测时）才可能有用。

生成包含 <n> 行上下文（而不是通常的三行）的 diff。隐含 --patch。

输出到特定文件而不是标准输出。

指定用于指示生成补丁中新行、旧行或上下文行的字符。通常它们分别是 +、- 和 ' '。

对于每个提交，使用原始 diff 格式显示更改摘要。请参阅 git-diff[1] 的“RAW OUTPUT FORMAT”部分。这与以原始格式显示日志本身不同，后者可以通过 --format=raw 实现。

-p --raw 的同义词。

在 diff 输出中显示树对象。

启用启发式算法，该算法会移动差异块边界，使补丁更易于阅读。这是默认设置。

禁用缩进启发式算法。

花费额外时间以确保生成最小的差异。

使用“patience diff”算法生成差异。

使用“histogram diff”算法生成差异。

使用“anchored diff”算法生成差异。

选择一种差异算法。变体如下：

生成 diffstat。默认情况下，文件名部分会使用尽可能多的空间，其余部分用于图表部分。最大宽度默认为终端宽度，如果未连接到终端则为 80 列，并且可以通过 <width> 覆盖。文件名部分的宽度可以通过提供一个逗号分隔的宽度 <name-width> 来限制，或者通过设置 diff.statNameWidth=<name-width> 来设置。图表部分的宽度可以通过使用 --stat-graph-width=<graph-width> 或设置 diff.statGraphWidth=<graph-width> 来限制。使用 --stat 或 --stat-graph-width 会影响所有生成 stat 图的命令，而设置 diff.statNameWidth 或 diff.statGraphWidth 则不会影响 git format-patch。通过提供第三个参数 <count>，可以限制输出为前 <count> 行，如果更多则显示 ...。

输出扩展头信息的紧凑摘要，例如文件创建或删除（“new”或“gone”，如果它是符号链接则可选 +l）以及模式更改（添加或删除可执行位则为 +x 或 -x）在 diffstat 中。该信息位于文件名部分和图形部分之间。隐含 --stat。

类似于 --stat，但以十进制显示添加和删除的行数，并省略路径名缩写，以便更易于机器处理。对于二进制文件，输出两个 - 而不是说 0 0。

仅输出 --stat 格式的最后一行，其中包含修改文件的总数，以及添加和删除的行数。

输出每个子目录相对更改量的分布。可以通过传递一个逗号分隔的参数列表来定制 --dirstat 的行为。默认值由 diff.dirstat 配置变量控制（参见 git-config[1]）。以下参数可用：

--dirstat=cumulative 的同义词。

--dirstat=files,<param>,... 的同义词。

输出扩展头信息的精简摘要，例如创建、重命名和模式更改。

-p --stat 的同义词。

使用 NUL 字符分隔提交，而不是换行符。

仅显示后像树中每个已更改文件的名称。文件名通常以 UTF-8 编码。有关更多信息，请参阅 git-log[1] 手册页中关于编码的讨论。

只显示每个已更改文件的名称和状态。有关状态字母的含义，请参见 --diff-filter 选项的说明。与 --name-only 类似，文件名通常使用 UTF-8 编码。

指定如何显示子模块的差异。当指定 --submodule=short 时，使用 short 格式。此格式仅显示范围开始和结束时的提交名称。当指定 --submodule 或 --submodule=log 时，使用 log 格式。此格式像 git-submodule[1] summary 一样列出范围内的提交。当指定 --submodule=diff 时，使用 diff 格式。此格式显示提交范围之间子模块内容更改的内联 diff。默认为 diff.submodule 或在配置选项未设置时为 short 格式。

显示彩色 diff。--color（即没有 =<when>）等同于 --color=always。<when> 可以是 always、never 或 auto 之一。

关闭彩色 diff。它与 --color=never 相同。

移动的代码行将以不同的颜色显示。如果不提供选项，<mode> 默认为 no；如果提供不带模式的选项，则默认为 zebra。模式必须是以下之一：

关闭移动检测。这可以用于覆盖配置设置。它与 --color-moved=no 相同。

这配置了在执行 --color-moved 的移动检测时如何忽略空白。这些模式可以作为逗号分隔的列表给出：

执行移动检测时不忽略空白。这可以用于覆盖配置设置。它与 --color-moved-ws=no 相同。

默认情况下，单词由空白分隔；参见下面的 --word-diff-regex。<mode> 默认为 plain，并且必须是以下之一：

使用 <regex> 来决定什么是单词，而不是将非空白字符的连续序列视为一个单词。除非已启用，否则这也隐含 --word-diff。

相当于 --word-diff=color 加上（如果指定了正则表达式）--word-diff-regex=<regex>。

关闭重命名检测，即使配置文件默认开启。

是否使用空 blob 作为重命名源。

当引入冲突标记或空格错误时发出警告。空格错误被认为是受 core.whitespace 配置控制的。默认情况下，行尾的空格（包括仅由空格组成的行）以及行开头缩进中紧跟在制表符后面的空格字符被视为空格错误。如果发现问题，退出状态将非零。与 --exit-code 不兼容。

在 diff 的 context、old 或 new 行中突出显示空格错误。多个值用逗号分隔，none 重置先前的值，default 将列表重置为 new，all 是 old,new,context 的简写。当未给出此选项，并且未设置配置变量 diff.wsErrorHighlight 时，仅突出显示 new 行中的空格错误。空格错误使用 color.diff.whitespace 着色。

在生成补丁格式输出时，不在“index”行上显示前几个字符，而是显示完整的原图像和后图像 blob 对象名称。

除了 --full-index 之外，还输出一个二进制 diff，该 diff 可以用 git-apply 应用。隐含 --patch。

在 diff-raw 格式输出和 diff-tree 头行中，不显示完整的 40 位十六进制对象名称，而是显示最短的前缀，该前缀至少有<n>个十六进制数字且能唯一标识对象。在 diff-patch 输出格式中，--full-index 具有更高的优先级，即如果指定了 --full-index，则无论 --abbrev 如何，都会显示完整的 blob 名称。可以使用 --abbrev=<n> 指定非默认的数字。

将完整的重写更改分解为删除和创建对。这有两个目的：

如果生成 diff，则为每个提交检测并报告重命名。要跟踪历史记录中文件重命名，请参阅 --follow。如果指定了 <n>，则它是相似性索引的阈值（即与文件大小相比的添加/删除量）。例如，-M90% 表示 Git 应将删除/添加对视为重命名，如果文件有 90% 以上未更改。如果不带 % 符号，则数字被视为带有小数点前的分数的。即 -M5 变为 0.5，因此等同于 -M50%。类似地，-M05 等同于 -M5%。要将检测限制为精确重命名，请使用 -M100%。默认相似性索引为 50%。

检测复制和重命名。另请参见 --find-copies-harder。如果指定了 <n>，其含义与 -M<n> 相同。

为了性能原因，默认情况下 -C 选项仅在复制的原始文件在同一更改集（changeset）中被修改时才查找复制。此标志使命令检查未修改的文件作为复制源的候选。对于大型项目，这是一项非常耗时的操作，因此请谨慎使用。给出多个 -C 选项具有相同的效果。

省略删除的原始文件（preimage），即只打印标头，而不打印原始文件与 /dev/null 之间的差异。生成的补丁不适用于 patch 或 git apply；这仅适用于那些只想专注于查看更改后文本的人。此外，输出显然缺乏足够的信息来手动甚至手动反向应用此类补丁，因此得名于该选项。

-M 和 -C 选项涉及一些初步步骤，可以廉价地检测重命名/复制的子集，然后是一个详尽的回退部分，将所有剩余未配对的目标与所有相关的源进行比较。（对于重命名，只有剩余未配对的源是相关的；对于复制，所有原始源都是相关的。）对于 N 个源和目标，此详尽检查的复杂度为 O(N^2)。如果涉及的源/目标文件数量超过指定数量，此选项将阻止重命名/复制检测的详尽部分运行。默认为 diff.renameLimit。请注意，值为 0 被视为无限制。

仅选择已添加（A）、复制（C）、删除（D）、修改（M）、重命名（R）、类型（即普通文件、符号链接、子模块等）已更改（T）、未合并（U）、未知（X）或配对已断开（B）的文件。可以组合使用任何过滤器字符（包括不使用）。当 *（全部或无）添加到组合中时，如果存在任何文件与其他标准匹配，则选择所有路径；如果没有文件与其他标准匹配，则不选择任何内容。

查找更改文件中指定 <string> 出现次数（即添加/删除）的差异。供脚本编写者使用。

查找其补丁文本包含与 <regex> 匹配的添加/删除行的差异。

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

查找更改指定对象出现次数的差异。类似于 -S，只是参数不同，它不搜索特定字符串，而是搜索特定对象 ID。

当 -S 或 -G 找到更改时，显示该变更集中所有更改，而不仅仅是包含 <string> 更改的文件。

将提供给 -S 的 <string> 视为扩展的 POSIX 正则表达式进行匹配。

控制文件中输出的顺序。这将覆盖 diff.orderFile 配置变量（参见 git-config[1]）。要取消 diff.orderFile，请使用 -O/dev/null。

从输出中丢弃指定 <file> 之前的（即 *skip to*）文件，或将它们移至输出末尾（即 *rotate to*）。这些选项主要用于 git difftool 命令，可能在其他情况下不太有用。

交换两个输入；即，显示从索引或磁盘文件到树内容的差异。

当从项目子目录运行时，可以使用此选项排除目录外的更改并显示相对于该目录的路径名。当您不在子目录中时（例如，在裸仓库中），可以通过提供 <path> 参数来指定要使输出相对的子目录。--no-relative 可用于抵消 diff.relative 配置选项和之前的 --relative。

将所有文件视为文本。

进行比较时忽略行尾的回车符。

忽略行尾空格的更改。

忽略空格数量的变化。这会忽略行尾的空格，并将所有其他一个或多个空格序列视为等效。

比较行时忽略空格。即使一行有空格而另一行没有，这也忽略了差异。

忽略所有空行的更改。

忽略所有行都匹配 <regex> 的更改。此选项可以多次指定。

在差异块之间显示上下文，最多达指定行数 <number>，从而合并彼此接近的块。默认为 diff.interHunkContext，如果未设置配置选项则为 0。

显示整个函数作为每个更改的上下文行。函数名称的确定方式与 git diff 生成补丁块标头的方式相同（参见 gitattributes[5] 中“定义自定义块标头”）。

允许执行外部差异辅助程序。如果您使用 gitattributes[5] 设置了外部差异驱动程序，则需要与 git-log[1] 等命令一起使用此选项。

禁止外部差异驱动程序。

允许（或不允许）在比较二进制文件时运行外部文本转换过滤器。有关详细信息，请参见 gitattributes[5]。由于 textconv 过滤器通常是单向转换，因此生成的差异适合人类阅读，但无法应用。因此，textconv 过滤器默认仅对 git-diff[1] 和 git-log[1] 启用，但不对 git-format-patch[1] 或 diff 管道命令启用。

在生成 diff 时忽略子模块的更改。all 是默认值。使用 none 时，子模块会被视为已修改，如果它包含未跟踪或已修改的文件，或者它的 HEAD 与超项目中记录的提交不同，并且可以用于覆盖 git-config[1] 或 gitmodules[5] 中 ignore 选项的任何设置。使用 untracked 时，子模块仅包含未跟踪内容时不会被视为脏（但仍会扫描以查找已修改内容）。使用 dirty 会忽略子模块工作树的所有更改，只显示超项目中存储的提交的更改（这是直到 1.7.0 的行为）。使用 all 会隐藏子模块的所有更改。

显示给定的源前缀 <prefix> 而不是 "a/"。

显示给定的目标前缀 <prefix> 而不是 "b/"。

不显示任何源或目标前缀。

使用默认的源和目标前缀（"a/" 和 "b/"）。这将覆盖配置变量，如 diff.noprefix、diff.srcPrefix、diff.dstPrefix 和 diff.mnemonicPrefix（参见 git-config[1]）。

在每行输出前面添加一个额外的 <prefix>。

默认情况下，由 git add -N 添加的条目在 git diff 中显示为现有空文件，在 git diff --cached 中显示为新文件。此选项使条目在 git diff 中显示为新文件，在 git diff --cached 中显示为不存在。此选项可以用 --ita-visible-in-index 恢复。这两个选项都是实验性的，未来可能会被删除。

对于命令行上给出的每个路径说明符，最多向下递归 <depth> 层目录。值为 -1 表示无限制。不能与路径说明符中的通配符组合使用。给定一个包含 foo/bar/baz 的树，以下列表显示了每个选项集生成的匹配项

显示整个提交历史，但跳过任何合并提交。

显示自版本 v2.6.12 以来所有更改了 include/scsi 或 drivers/scsi 子目录中任何文件的提交。

显示过去两周内对 gitk 文件进行的更改。-- 是必需的，以避免与名为 gitk 的分支混淆。

显示 "test" 分支中有但尚未在 "release" 分支中的提交，以及每个提交修改的路径列表。

显示更改了 builtin/rev-list.c 的提交，包括在文件获得当前名称之前的提交。

显示本地分支中存在但不在 origin 的任何远程跟踪分支中的所有提交（即您拥有但 origin 没有的）。

显示本地 master 分支中有但不在任何远程仓库 master 分支中的所有提交。

显示包含更改 diff 的历史记录，但仅从“主分支”的角度来看，跳过来自合并分支的提交，并显示合并引入的更改的完整 diff。这仅在遵循严格的策略，即在单个集成分支上合并所有主题分支时才有意义。

显示文件 main.c 中的函数 main() 随时间的演变。

将要显示的提交数量限制为 3。

--format 选项的默认值。（参见上面的Pretty Formats。）默认为 medium。

显示日志时要使用的编码。（参见上面的Discussion。）如果设置了 i18n.commitEncoding，则默认为其值，否则默认为 UTF-8。

如果为 true，则使 git-log[1]、git-show[1] 和 git-whatchanged[1] 假定为 --abbrev-commit。您可以使用 --no-abbrev-commit 覆盖此选项。

设置 log 命令的默认日期/时间模式。设置 log.date 的值类似于使用 git log 的 --date 选项。有关详细信息，请参阅 git-log[1]。

打印日志命令显示的任何提交的 ref 名称。可能的值包括：

默认情况下，git log 仅显示某些已知 ref 命名空间中的装饰。如果指定了 all，则显示所有 ref 作为装饰。

从日志装饰中排除指定的模式。这类似于 --decorate-refs-exclude 命令行选项，但配置选项可以被 --decorate-refs 选项覆盖。

设置指定 --diff-merges=on 时要使用的 diff 格式，有关详细信息，请参阅 git-log 中的 --diff-merges。separate 是默认值。

如果为 true，则当只给定一个 <path> 时，git log 的行为将如同使用了 --follow 选项。这与 --follow 具有相同的限制，即不能用于跟踪多个文件，并且在非线性历史记录上效果不佳。

在 git log --graph 中用于绘制历史记录线的颜色列表，用逗号分隔。

如果为 true，则初始提交将显示为一个大的创建事件。这等同于与空树的 diff。像 git-log[1] 或 git-whatchanged[1] 这样的工具，通常会隐藏根提交，但现在会显示它。默认为 true。

如果为 true，则使 git-log[1]、git-show[1] 和 git-whatchanged[1] 假定为 --show-signature。

如果为 true，则使 git-log[1]、git-show[1] 和 git-whatchanged[1] 假定为 --use-mailmap，否则假定为 --no-use-mailmap。默认为 true。

解决 notes 冲突时默认选择的合并策略。必须是 manual、ours、theirs、union 或 cat_sort_uniq 之一。默认为 manual。有关每种策略的更多信息，请参阅 git-notes[1] 的“NOTES MERGE STRATEGIES”部分。

在将 notes 合并到 refs/notes/<name> 时选择的合并策略。这会覆盖更通用的 notes.mergeStrategy。有关可用策略的更多信息，请参阅 git-notes[1] 的“NOTES MERGE STRATEGIES”部分。

除了由 core.notesRef 或 GIT_NOTES_REF 默认设置之外，还从哪个 ref（或 refs，如果是 glob 或指定多次）读取 notes，用于在显示提交消息时（使用 git-log[1] 系列命令）。

使用 <command>（当前为 amend 或 rebase）重写提交时，如果此变量为 false，则 git 不会从原始提交复制 notes 到重写的提交。默认为 true。另请参阅下面的 notes.rewriteRef。

复制重写笔记时（请参阅 notes.rewrite.<command> 选项），确定在目标提交已包含笔记时应执行的操作。必须是以下值之一：overwrite、concatenate、cat_sort_uniq 或 ignore。默认为 concatenate。

在重写期间复制备注时，指定（完全限定的）要复制备注的引用。可以是一个 glob，在这种情况下，所有匹配引用中的备注都将被复制。您也可以多次指定此配置。