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

抑制 diff 机制的所有输出。对于像 git show 这样的默认显示补丁的命令很有用，可以抑制它们的输出，或者取消命令行中前面选项（如 --patch、--stat）在别名中的效果。

生成具有 <n> 行上下文而不是通常的三行的差异。隐含 --patch。

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

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

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

-p --raw 的同义词。

启用将差异块边界移动以使补丁更易于阅读的启发式方法。这是默认设置。

禁用缩进启发式方法。

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

使用“耐心差异”算法生成差异。

使用“直方图差异”算法生成差异。

使用“锚定差异”算法生成差异。

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

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

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

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

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

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

与 --dirstat=cumulative 同义。

与 --dirstat=files,<param1>,<param2>…​ 同义。

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

与 -p --stat 同义。

当给出 --raw、--numstat、--name-only 或 --name-status 时，不要混淆路径名，并使用 NUL 作为输出字段终止符。

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

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

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

显示彩色差异。--color（即不带=<when>）与 --color=always 相同。<when> 可以是 always、never 或 auto 之一。

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

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

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

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

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

显示单词差异，使用<mode>分隔更改的单词。默认情况下，单词由空格分隔；请参见下面的 --word-diff-regex。<mode>默认为plain，并且必须是以下之一：

使用<regex>来决定什么是单词，而不是将非空格字符的运行视为单词。除非已启用，否则还暗示 --word-diff。

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

关闭重命名检测，即使配置文件给出默认执行此操作。

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

如果更改引入了冲突标记或空格错误，则发出警告。空格错误的考虑因素由 core.whitespace 配置控制。默认情况下，尾随空格（包括仅由空格组成的行）以及在行的初始缩进内紧跟制表符的空格字符被视为空格错误。如果发现问题，则以非零状态退出。与 --exit-code 不兼容。

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

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

除了--full-index之外，还输出一个可以用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 之间的差异。生成的补丁不打算与 patch 或 git apply 一起应用；这仅适用于希望专注于查看更改后文本的人员。此外，输出显然缺乏足够的信息来反向应用此类补丁，即使是手动操作，因此得名。

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

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

查找更改指定字符串出现次数（即添加/删除）的文件差异。旨在供脚本编写者使用。

查找其补丁文本包含与 <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> 之前的文件（即跳过到），或将其移动到输出的末尾（即旋转到）。这些选项主要是为了 git difftool 命令的使用而发明的，否则可能不是很有用。

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

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

将所有文件视为文本。

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

忽略行尾空格的更改。

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

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

忽略所有行都为空白的更改。

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

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

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

使程序退出代码类似于diff(1)。也就是说，如果存在差异，则退出代码为1；如果不存在差异，则退出代码为0。

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

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

不允许使用外部 diff 驱动程序。

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

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

显示给定的源前缀，而不是“a/”。

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

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

使用默认的源和目标前缀（“a/”和“b/”）。这将覆盖配置变量，例如diff.noprefix、diff.srcPrefix、diff.dstPrefix和diff.mnemonicPrefix（请参阅git-config(1)）。

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

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

要进行 diff 的树对象的 ID。

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

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

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

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

比较<tree-ish>和索引。

比较两个参数指定的树。

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