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

抑制所有来自 diff 机制的输出。对于默认显示补丁的命令（例如 git show）很有用，可以取消其输出，或用于在别名中取消命令行中较早出现的 --patch、--stat 等选项的效果。

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

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

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

以原始格式生成 diff。这是默认设置。

-p --raw 的同义词。

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

禁用缩进启发式算法。

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

使用“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> 行，如果还有更多行，则后面跟 ...。

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

类似于 --stat，但以十进制表示法显示添加和删除的行数，并且不缩写路径名，以使其更具机器友好性。对于二进制文件，输出两个 - 而不是 0 0。

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

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

--dirstat=cumulative 的同义词。

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

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

-p --stat 的同义词。

当给定 --raw、--numstat、--name-only 或 --name-status 时，不修改路径名，并使用 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> 指定。

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

检测重命名。如果指定了 <n>，它是一个相似度索引的阈值（即，与文件大小相比的添加/删除量）。例如，-M90% 意味着如果文件超过 90% 未更改，Git 应将删除/添加对视为重命名。如果没有 % 符号，则该数字应视为分数，前面有一个小数点。即，-M5 变为 0.5，因此与 -M50% 相同。类似地，-M05 与 -M5% 相同。要将检测限制为精确重命名，请使用 -M100%。默认相似度索引为 50%。

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

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

删除时省略原始映像，即只打印头信息，而不打印原始映像与 /dev/null 之间的 diff。生成的补丁不适用于 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 生成补丁 hunk 头的方式相同（参见 gitattributes[5] 中“定义自定义 hunk-header”）。

使程序以类似于 diff(1) 的代码退出。也就是说，如果存在差异，则以 1 退出，0 表示无差异。

禁用程序的所有输出。隐含 --exit-code。禁用外部 diff 助手的执行，其退出代码不受信任，即其各自的配置选项 diff.trustExitCode 或 diff.<driver>.trustExitCode 或环境变量 GIT_EXTERNAL_DIFF_TRUST_EXIT_CODE 为 false。

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

禁止外部差异驱动程序。

允许（或不允许）在比较二进制文件时运行外部文本转换过滤器。有关详细信息，请参见 gitattributes[5]。由于 textconv 过滤器通常是单向转换，因此生成的 diff 适合人工阅读，但无法应用。因此，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 恢复。这两个选项都是实验性的，未来可能会被移除。

要比较的树对象的 ID。

根本不考虑磁盘上的文件。

不直接比较 <tree-ish>，而是使用 <tree-ish> 和 HEAD 之间的合并基础。<tree-ish> 必须是一个提交。

默认情况下，索引中记录但未检出的文件会报告为已删除。此标志使 git diff-index 声明所有未检出的文件都是最新的。

比较 <tree-ish> 和文件系统上的文件。

比较 <tree-ish> 和索引。

比较由两个参数命名的树。

比较索引和文件系统上的文件。