继续列出文件的历史记录，包括重命名之后的情况（仅适用于单个文件）。

打印显示的任何提交的引用名称。如果指定了 "short"，则不会打印引用名称的前缀 "refs/heads/"、"refs/tags/" 和 "refs/remotes/"。如果指定了 "full"，将打印完整的引用名称（包括前缀）。如果指定了 "auto"，则如果输出是发送到终端，则显示引用名称，就如同指定了"short"一样，否则不显示引用名称。选项 --decorate 是 --decorate=short 的简写。如果配置了 log.decorate 的配置值，默认为配置值，否则为 "auto"。

对于每个候选引用，在以下情况下不要将其用于装饰（decorate）：若它与`--decorate-refs-exclude`指定的任何模式匹配，或者若它不与`--decorate-refs`指定的任何模式匹配。配置选项`log.excludeDecoration`允许从装饰中排除引用，但是在`log.excludeDecoration`中的匹配项将被`--decorate-refs`模式中的显式指定所覆盖。

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

打印出通过命令行给定的引用名称，以便触及每个提交。

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

如果不使用此标志， git log -p <path>... 将显示与指定路径相关的提交，并显示关于相同指定路径的差异。使用此标志，将显示与指定路径相关的提交的完整差异；这意味着 "<path>…​" 将仅限定提交，并不限定这些提交的差异。

在每个提交的输出中包含一行 ``log size <number>"" ，其中 <number> 是该提交消息的字节长度。旨在通过允许工具预先分配空间，加快从 git log 输出中读取日志消息的工具的速度。

追踪由 <起始>,<结束> 给出的行的范围，或由函数名称重合词 <函数名称> 给出的行的演变，在 <文件>'中 。你不能给出任何路径规范限制条件。 目前这只限于从一个修订版开始的行走，也就是说，你只能给出零或一个正的修订版参数，而且 '<起始> 和 <结束>（或 <函数名称>）必须存在于起始修订版中。 你可以多次指定这个选项。包含 --patch 选项。 补丁输出可以用 --no-patch 来抑制，但其他差异格式（即 --raw 、 --numstat 、 --shortstat 、 --dirstat 、 --summary 、 --name-only 、 --name-status 、 --check）目前没有实现。

仅显示指定修订范围内的提交。当没有指定 <revision-range> 时，默认为 HEAD（即导致当前提交的整个历史记录）。origin..HEAD 指定从当前提交（即 HEAD ）可达的所有提交，但不包括从 origin 可达的提交。有关拼写 <revision-range> 的完整列表，请参阅 gitrevisions[7] 的 "Specifying Ranges" 部分。

只显示那些足以解释符合指定路径的文件是如何形成的提交。 有关细节和其他简化模式，请参见下面的’历史简化'。

生成补丁（请参阅 使用选项 -p 生成补丁文本 ）。

抑制差异（diff）工具的所有输出。 对于默认显示补丁的 git show 等命令，可以压制其输出，或在别名中取消命令行中的 --patch、--stat 等选项的效果。

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

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

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

为合并提交和常规提交生成与第一父提交的差异。 --diff-merges=first-parent -p 的快捷方式。

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

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

指定合并提交时使用的差异格式。默认为 `off`，但当使用 --first-parent 选项时，默认为 first-parent。

这个标志会使合并后的差异文件（用于合并提交）列出所有父提交的名称。，因此它只在使用 --diff-merges=[dense-]combined 时有效。其可能在检测到文件名变化时有用（例如，当要求检测重命名或复制时）。

生成带有 <n> 行上下文的差异，而不是通常的 3 行。暗含 --patch 选项。 暗含 --patch 选项。

输出到一个特定的文件，而不是标准输出。

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

对于每一个提交，使用原始的差异格式 请参见 git-diff[1] 中 “原始输出格式” 一节 。 这与显示日志中的本身的原始格式不同 你可以用 --format=raw 来实现。

-p--raw 的同义词。

在差异输出中显示目录树对象。

启用启发式的缩进区块的方法，使得补丁更易读。这是默认选项。

禁用启发式缩进。

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

使用 "patience diff" 算法生成差异。

使用 "histogram diff" 算法生成差异。

使用 "anchored diff" 算法生成差异。

选择差异算法。有如下可选项：

生成差异统计（diffstat）。默认情况下，文件名部分将使用尽可能多的空间，其余空间用于图表部分。最大宽度默认为终端宽度，如果未连接终端，则为 80 列，可以用 <最大宽度>`覆盖。文件名部分的宽度可以通过在逗号后另加宽度 `<文件名宽度>`或设置 `diff.statNameWidth=<文件名宽度>`来限制。图形部分的宽度可以通过使用 `--stat-graph-width=<图形宽度>`或设置 `diff.statGraphWidth=<图像宽度> 来限制。使用 --stat 或 --stat-graph-width 选项会影响所有生成统计图的命令，而设置 diff.statNameWidth 或 diff.statGraphWidth 则不会影响 git format-patch。 通过给出第三个参数 <行数>，可以将输出限制在前 <行数>`行，如果行数更多，则在后面加上 `...。

在差异状态中输出扩展头信息的压缩摘要，如文件的创建或删除（"new" 或 "good"。如果是符号链接，则为 "+l"）和模式变化（"+x" 或 "-x" 分别用于添加或删除可执行位）。这些信息被放在文件名部分和图形部分之间。暗含 --stat 选项。

类似于 --stat，但是使用小数点和不含缩写的路径名显示添加和删除的行数，使其对程序更友好。对于二进制文件，输出两个 -，而不是 0 0。

只输出使用 --stat 选项输出的最后一行，包含修改的文件总数，添加和删除的行数。

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

--dirstat=cumulative 同义

与 --dirstat=files,<参数 1>,<参数 2> 同义

输出扩展头信息，如创建、重命名和模式变化等，的压缩摘要。

同义词 -p --stat。

用 NUL 而不是用换行来分隔提交。

Show only the name of each changed file in the post-image tree. The file names are often encoded in UTF-8. For more information see the discussion about encoding in the git-log[1] manual page.

Show only the name(s) and status of each changed file. See the description of the --diff-filter option on what the status letters mean. Just like --name-only the file names are often encoded in UTF-8.

指定子模块中的差异如何显示。当指定 --submodule=short 选项时，会使用 short 格式。这种格式只显示范围的开头和结尾处的提交名称。当指定了 --submodule 或 --submodule=log 时，会使用 log 格式。这种格式会像 git-submodule[1] summary 那样，列出该范围内的提交。当指定了 --submodule=diff 时，会使用 diff 格式。这个格式显示的是子模块内在提交范围之间的变化差异。默认为 diff.submodule，如果配置选项未设置， 则为 short 格式。

显示有颜色的差异。--color（即不含 =<何时>）与 --color=always 相同。<何时> 可以是 always、never 或 auto。

关掉带彩色显示的差异。 这和 --color=never 相同。

移动的代码行的颜色不同。 如果没有给出该选项，<模式> 默认为 no 如果没有给定模式选项，则为 zebra。 该模式必须以下其中之一：

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

这将配置在执行 --color-moved 选项的移动检测时如何忽略空格。 这些模式可以通过以逗号分隔的列表给出：

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

显示词的差异，用 <模式> 来分隔已更改的词。默认情况下，单词是以空格分隔；请参考 --word-diff-regex。<模式> 默认为 plain，并且必须是以下其中之一：

使用 <正则表达式> 来确定单词的格式，而不是将一串非空白行视为单词。除非已启用，否则还暗含 --word-diff 选项。

与 --word-diff=color 和（如果指明了正则表达式）--word-diff-regex=<正则表达式> 两个选项含义相同。

关闭重命名检测，即使配置文件给出的默认是这样做。

是否使用空的数据对象作为重命名源。

如果更改引入冲突标记或空格错误，则发出警告。哪些被认为是空格错误是由 core.whitespace 配置控制的。默认情况下，行尾部的空格字符（包括仅由空格字符组成的行）和紧跟在行初缩进内 tab 字符后的空格字符，都被认为是空格字符错误。如果发现问题，则以非零状态退出。与 --exit-code 选项不兼容。

突出显示差异中 context（上下文）、old（旧）或 new（新）行中的空格错误。多个值用逗号隔开，none 选项会重置以前的值，default 重置列表为 new，all 是 old,new,context 的简写。当没有给定这个选项，并且配置变量 diff.wsErrorHighlight 没有设置时，只有 new 行中的空格错误会被高亮显示。空格错误会用 color.diff.whitespace 配置进行着色。

在生成补丁格式输出时，在 index（索引）行上显示完整的图像前和图像后数据对象名称，而不仅是前几个字符。

除了 --full-index 输出的差异之外，输出二进制的差异。其可以用 git-apply 命令来应用。暗含 --patch 选项。 暗含 --patch 选项。

在 diff-raw 格式输出和 diff-tree 头文件行中，不显示完整的 40 字节十六进制对象名称，而是显示唯一指向对象的最短前缀，长度至少为 <n> 位十六进制数字。 在 diff-patch 输出格式中，--full-index 优先，也就是说，如果指定了 --full-index，则无论 --abbrev 如何，都会显示完整的 blob 名称。 可以使用 --abbrev=<n> 指定非默认位数。

将完整的重写更改切分成删除和创建对（pair）。这有两个目的：

如果制成差异，检测并报告每个提交中的重命名。 对于每个在遍历历史时重命名的文件，参见 --follow。 如果指定了 n，则其为相似度指数阈值（即相比于文件大小的增/删量）。 例如，-M90％ 表示如果文件90％以上的内容没有更改，则 Git 应将删除/添加对视为重命名。 如果没有 ％ 符号，则该数字应作为小数读取，并在其前面加上小数点。 即 -M5 变为 0.5，因此与 -M50％ 相同。 同样，-M05 与 -M5％ 相同。 要将检测限制为精确的重命名，请使用 -M100％。 默认相似度指数为50％。

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

出于性能考虑，默认情况下，-C 选项只在复制的原始文件在相同的变更集中被修改时才会查找复制。这个标志使命令检查未修改的文件作为复制源的候选文件。 对于大型项目来说，这是一个非常耗时的操作，所以要谨慎使用。 给出一个以上的 -C 选项有同样的效果。

删除时省略原内容，即只打印头信息，而不打原内容和 /dev/null 之间的差异。所产生的补丁并不是要用于 patch 或 git apply；这只是为了让人们只专注于审查修改后的文本。此外，输出结果显然缺乏足够的信息来反转，或手动应用这样一个补丁，因此这个选项的名称如此。

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

只选择添加（A）、复制（C）、删除（D）、修改（M）、重命名（R）、类型（即常规文件、符号链接、子模块…​…​）改变（T）、未合并（U）、未知（X）或配对被破坏（B）的文件。可以使用过滤字符的任何组合（包括空）。当组合中加入 *（全部或空）时，如果在比较中有任何文件与其他条件匹配，则选择所有路径；如果没有符合其他条件的文件，则不会选择任何内容。

寻找改变文件中指定字符串出现次数的差异（即增加/删除）。供脚本编写者使用。

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

+    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。

从输出中丢弃命名 <文件> 之前的文件（即 skip to），或将它们移到输出的末尾（即 rotate to）。 这些选项主要是为使用 git difftool 命令而发明的，在其他情况下可能用处不大。

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

当从项目的子目录中运行时，可以排除目录外的变化，并通过这个选项显示相对于它的路径名。当你不在子目录中时（例如在纯仓库中），你可以通过 <路径> 参数来指明要使输出相对于哪个子目录。--no-relative 可以用来取消 diff.relative`配置选项和之前的 `--relative 选项。

将一切输入文件视为文本。

在进行比较时，忽略行末的回车。

忽略行尾空格的变化。

忽略空格数量的变化。这会忽略行尾的空格，并认为包含一个或多个空格字符的其他序列都是等同的。

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

忽略空白行的变化。

忽略所有行均匹配 <正则表达式> 的更改。 此选项可指定多次。

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

在每个修改中的上下文行显示整个函数。函数名称的确定方式与 git diff 计算补丁头的方式相同（参见 gitattributes[5] 中的 自定义区块头 ）。

允许执行外部差异器。如果你用 gitattributes[5] 设置了一个外部差异驱动程序，你需要在 git-log[1] 和相关命令中使用这个选项。

禁止使用外部差异器。

允许（或不允许）在比较二进制文件时运行外部文本转换过滤器。详情请参见 gitattributes[5] 。由于文本转换过滤器通常是单向转换，因此产生的差异适合人类用户使用，但不能应用（apply）。因此默认情况下，只有 git-diff[1] 和 git-log[1] 启用文本转换过滤器，而 git-format-patch[1] 或 diff plumbing 命令则不启用。

在生成差异时忽略子模块的修改。<when> 可以是 "none"、"untracked"、"dirty " 或 "all"，"all" 是默认选项。使用 "none" 会在子模块包含未跟踪或修改的文件，或者它的HEAD 与上级项目中记录的提交不同时，认为它被修改了，并且可以用来覆盖 git-config[1] 或 gitmodules[5] 中 忽略 选项的设置。当使用 "untracked" 时，当子模块只包含未跟踪的内容时，它们不会被认为是有改动的（但它们仍然会被扫描是否有被修改的内容）。使用 "dirty" 会忽略所有对子模块工作树的修改，只有存储在上级项目中的提交的修改才会被显示出来（这是在1.7.0之前的行为）。使用 "all" 会隐藏所有对子模块的修改。

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

显示给定的目标前缀，而不是“b/”。

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

Use the default source and destination prefixes ("a/" and "b/"). This overrides configuration variables such as diff.noprefix, diff.srcPrefix, diff.dstPrefix, and diff.mnemonicPrefix (see git-config(1)).

在每一行输出前加上一个额外的前缀。

默认情况下，通过 "git add -N" 添加的条目在 "git diff" 中显示为现有的空文件，在 "git diff --cached" 中显示为新文件。这个选项使得条目在 "git diff" 中显示为一个新文件，而在 "git diff --cached" 中显示为不存在的文件。这个选项可以用 --ita-visible-in-index 来还原。这两个选项都是试验性的，将来可能会被删除。

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

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

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

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

显示改变`builtin/rev-list.c`的提交，包括那些在文件被赋予现在名字之前发生的提交。

显示所有在本地分支中但不在 "origin "的远程跟踪分支中的提交（你有而origin没有的东西）。

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

显示包括变化差异的历史，但只从 "主分支 "的角度，跳过来自合并分支的提交，并显示合并带来的全部变化差异。 这只有在遵循严格的政策，在停留在一个集成分支时合并所有主题分支时才有意义。

显示了文件`main.c`中的函数`main()`是如何随时间演变的。

将显示的提交数量限制在3个。

`--format`选项的默认值。 (见上面的 "漂亮的格式"。)默认为 "中等"。

显示日志时要使用的编码。 (见上面的 "讨论"。)如果设置了，默认为`i18n.commitEncoding`的值，否则为UTF-8。