English ▾ 主题 ▾ 最新版本 ▾ git-diff 上次更新于 2.49.0

名称

git-diff - 显示提交之间、提交和工作树之间等的更改

概要

git diff [<选项>] [<提交>] [--] [<路径>…​] git diff [<选项>] --cached [--merge-base] [<提交>] [--] [<路径>…​] git diff [<选项>] [--merge-base] <提交> [<提交>…​] <提交> [--] [<路径>…​] git diff [<选项>] <提交>…​<提交> [--] [<路径>…​] git diff [<选项>] <blob> <blob> git diff [<选项>] --no-index [--] <路径> <路径>

描述

显示工作树和索引或树之间的更改，索引和树之间的更改，两个树之间的更改，合并产生的更改，两个 blob 对象之间的更改，或磁盘上两个文件之间的更改。

git diff [<options>] [--] [<path>...]

此形式用于查看您相对于索引（下一个提交的暂存区）所做的更改。换句话说，这些差异是您可以告诉 Git 将其进一步添加到索引，但您仍然没有添加的内容。您可以使用 git-add[1] 暂存这些更改。

git diff [<options>] --no-index [--] <path> <path>

此形式用于比较文件系统上给定的两个路径。在由 Git 控制的工作树中运行命令，并且至少一个路径指向工作树之外，或者在由 Git 控制的工作树之外运行命令时，您可以省略 --no-index 选项。此形式意味着 --exit-code。

git diff [<options>] --cached [--merge-base] [<commit>] [--] [<path>...]

此形式用于查看相对于指定的 *<commit>* 为下一次提交暂存的更改。 通常，您希望与最新的提交进行比较，因此如果您不给出 *<commit>*，则默认为 HEAD。如果 HEAD 不存在（例如，未出生的分支），并且未给出 *<commit>*，则会显示所有暂存的更改。 --staged 是 --cached 的同义词。

如果给出了 --merge-base，则使用 *<commit>* 和 HEAD 的合并基，而不是使用 *<commit>*。 git diff --cached --merge-base A 等价于 git diff --cached $(git merge-base A HEAD)。

git diff [<options>] [--merge-base] <commit> [--] [<path>...]

此形式用于查看您在工作树中相对于指定的 *<commit>* 所做的更改。 您可以使用 HEAD 将其与最新的提交进行比较，或使用分支名称与另一个分支的顶端进行比较。

如果给出了 --merge-base，则使用 *<commit>* 和 HEAD 的合并基，而不是使用 *<commit>*。 git diff --merge-base A 等价于 git diff $(git merge-base A HEAD)。

git diff [<options>] [--merge-base] <commit> <commit> [--] [<path>...]

这是用于查看两个任意 *<commit>* 之间的更改。

如果给出了 --merge-base，则对“before”端使用两个提交的合并基。 git diff --merge-base A B 等价于 git diff $(git merge-base A B) B。

git diff [<options>] <commit> <commit>...<commit> [--] [<path>...]

此形式用于查看合并提交的结果。第一个列出的 *<commit>* 必须是合并本身；其余的两个或更多提交应该是其父提交。生成所需修订集的便捷方法是使用后缀 @ 和 ^!。如果 A 是合并提交，则 git diff A A^@、git diff A^! 和 git show A 都会给出相同的组合差异。

git diff [<options>] <commit>..<commit> [--] [<path>...]

这与早期形式（没有 ..）同义，用于查看两个任意 *<commit>* 之间的更改。 如果省略一侧的 *<commit>*，则其效果与使用 HEAD 相同。

git diff [<options>] <commit>...<commit> [--] [<path>...]

此形式用于查看包含第二个 *<commit>* 的分支上的更改，直到第二个 *<commit>*，从两个 *<commit>* 的共同祖先开始。 git diff A...B 等价于 git diff $(git merge-base A B) B。您可以省略任何一个 *<commit>*，其效果与使用 HEAD 相同。

以防万一您正在做一些奇怪的事情，应该注意的是，上述描述中的所有 *<commit>*，除了在 --merge-base 的情况下以及最后两种使用 .. 表示法的形式之外，都可以是任何 *<tree>*。感兴趣的树是由名为 AUTO_MERGE 的 ref 指向的树，它由 ort 合并策略在遇到合并冲突时写入（请参阅 git-merge[1]）。将工作树与 AUTO_MERGE 进行比较会显示您到目前为止为解决文本冲突所做的更改（请参阅下面的示例）。

有关拼写 *<commit>* 的更完整方法列表，请参阅 gitrevisions[7] 中的“SPECIFYING REVISIONS”部分。但是，diff 是关于比较两个端点，而不是范围，并且范围表示法（<commit>..<commit> 和 <commit>...<commit>）并不意味着 gitrevisions[7] 中的“SPECIFYING RANGES”部分中定义的范围。

git diff [<options>] <blob> <blob>

此形式用于查看两个 blob 对象的原始内容之间的差异。

选项

-p
-u
--patch

生成补丁（请参阅 使用 -p 生成补丁文本）。这是默认设置。

-s
--no-patch

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

-U<n>
--unified=<n>

生成带有 *<n>* 行上下文的 diff，而不是通常的三行。意味着 --patch。

--output=<file>

输出到特定文件而不是 stdout。

--output-indicator-new=<char>
--output-indicator-old=<char>
--output-indicator-context=<char>

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

--raw

以原始格式生成差异。

--patch-with-raw

与 -p --raw 同义。

--indent-heuristic

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

--no-indent-heuristic

禁用缩进启发式算法。

--minimal

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

--patience

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

--histogram

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

--anchored=<text>

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

此选项可以多次指定。

如果一行同时存在于源和目标中，只存在一次，并且以 *<text>* 开头，则此算法会尝试防止它在输出中显示为删除或添加。它在内部使用 “耐心差异” 算法。

--diff-algorithm=(patience|minimal|histogram|myers)

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

default
myers

基本贪婪差异算法。目前，这是默认设置。

minimal

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

patience

在生成补丁时使用 “耐心差异” 算法。

histogram

此算法扩展了耐心算法以“支持低频常见元素”。

例如，如果您将 diff.algorithm 变量配置为非默认值，并且想要使用默认值，则必须使用 --diff-algorithm=default 选项。

--stat[=<width>[,<name-width>[,<count>]]]

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

这些参数也可以使用 --stat-width=<width>、--stat-name-width=<name-width> 和 --stat-count=<count> 单独设置。

--compact-summary

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

--numstat

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

--shortstat

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

-X [<param>,...]
--dirstat[=<param>,...]

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

changes

通过计算从源中删除或添加到目标中的行来计算 dirstat 数字。 这忽略了文件中纯代码移动的数量。 换句话说，重新排列文件中的行不像其他更改那样被计数。 这是未给出参数时的默认行为。

lines

通过执行常规的基于行的差异分析，并对删除/添加的行数进行求和来计算 dirstat 数字。 （对于二进制文件，计算 64 字节的块，因为二进制文件没有行的自然概念）。 这是一种比 changes 行为更昂贵的 --dirstat 行为，但它会像其他更改一样计算文件中的重新排列行。 生成的输出与您从其他 --*stat 选项中获得的结果一致。

files

通过计算已更改文件的数量来计算 dirstat 数字。 每个已更改的文件在 dirstat 分析中都同样计数。 这是计算成本最低的 --dirstat 行为，因为它根本不必查看文件内容。

cumulative

计算父目录中子目录的更改。 请注意，当使用 cumulative 时，报告的百分比之和可能超过 100%。 默认（非累积）行为可以使用 noncumulative 参数指定。

<limit>

整数参数指定一个截止百分比（默认为 3%）。 贡献小于此百分比的更改的目录不会显示在输出中。

示例：以下命令将计算已更改的文件，同时忽略已更改文件总数少于 10% 的目录，并将子目录计数累积到父目录中：--dirstat=files,10,cumulative。

--cumulative

与 --dirstat=cumulative 同义。

--dirstat-by-file[=<param>,...]

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

--summary

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

--patch-with-stat

与 -p --stat 同义。

-z

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

如果没有此选项，具有“不寻常”字符的路径名将按照配置变量 core.quotePath 的说明进行引用（参见 git-config[1]）。

--name-only

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

--name-status

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

--submodule[=<format>]

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

--color[=<when>]

显示彩色差异。 --color（即没有 =<when>）与 --color=always 相同。 <when> 可以是 always、never 或 auto 之一。 可以通过 color.ui 和 color.diff 配置设置对其进行更改。

--no-color

关闭彩色差异。 这可以用于覆盖配置设置。 它与 --color=never 相同。

--color-moved[=<mode>]

移动的代码行以不同的颜色显示。 可以通过 diff.colorMoved 配置设置对其进行更改。 如果未给出该选项，则 <mode> 默认为 no，如果给出没有模式的选项，则默认为 zebra。 该模式必须是以下之一：

no

不突出显示移动的行。

default

是 zebra 的同义词。 这可能会在将来更改为更合理的模式。

plain

在一个位置添加并在另一个位置删除的任何行都将使用 color.diff.newMoved 进行着色。 类似地，color.diff.oldMoved 将用于在差异中其他位置添加的已删除行。 此模式会拾取任何移动的行，但在审查中确定是否在没有排列的情况下移动了一段代码并不是很有用。

blocks

贪婪地检测至少 20 个字母数字字符的移动文本块。 检测到的块使用 color.diff.(old|new)Moved 颜色绘制。 相邻的块无法区分。

zebra

移动的文本块的检测方式与 blocks 模式相同。 这些块使用 color.diff.(old|new)Moved 颜色或 color.diff.(old|new)MovedAlternative 绘制。 两种颜色之间的变化表明检测到了一个新的块。

dimmed-zebra

类似于 zebra，但会对移动代码中不重要的部分进行额外的弱化显示。两个相邻块的边界行被认为是重要的，其余的则不重要。dimmed_zebra 是一个已弃用的同义词。

--no-color-moved

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

--color-moved-ws=<mode>,...

配置在为 --color-moved 执行移动检测时如何忽略空格。可以通过 diff.colorMovedWS 配置设置进行设置。这些模式可以以逗号分隔的列表给出

no

在执行移动检测时不要忽略空格。

ignore-space-at-eol

忽略行尾空格的更改。

ignore-space-change

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

ignore-all-space

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

allow-indentation-change

最初忽略移动检测中的任何空格，然后仅当每行空格的更改相同才将移动的代码块分组到一个块中。这与其他模式不兼容。

--no-color-moved-ws

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

--word-diff[=<mode>]

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

color

仅使用颜色突出显示更改的单词。暗示 --color。

plain

将单词显示为 [-removed-] 和 {added}。如果分隔符出现在输入中，则不尝试转义分隔符，因此输出可能不明确。

porcelain

使用专为脚本消耗而设计的特殊行格式。添加/删除/未更改的运行以通常的统一差异格式打印，以行开头的 +/-/` ` 字符开始，并延伸到行尾。输入中的换行符由其自身行上的波浪号 ~ 表示。

none

再次禁用单词差异。

请注意，尽管第一个模式的名称如此，但如果启用，则颜色用于突出显示所有模式中的更改部分。

--word-diff-regex=<regex>

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

<regex> 的每个非重叠匹配项都被认为是一个单词。这些匹配项之间的任何内容都被视为空格，并且在查找差异时被忽略（！）。您可能希望将 |[^[:space:]] 附加到您的正则表达式，以确保它匹配所有非空格字符。包含换行符的匹配项会在换行符处被静默截断（！）。

例如，--word-diff-regex=. 会将每个字符视为一个单词，并相应地按字符显示差异。

也可以通过差异驱动程序或配置选项设置正则表达式，参见 gitattributes[5] 或 git-config[1]。显式给出它会覆盖任何差异驱动程序或配置设置。差异驱动程序会覆盖配置设置。

--color-words[=<regex>]

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

--no-renames

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

--[no-]rename-empty

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

--check

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

--ws-error-highlight=<kind>

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

--full-index

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

--binary

除了 --full-index 之外，还输出可以使用 git-apply 应用的二进制差异。暗示 --patch。

--abbrev[=<n>]

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

-B[<n>][/<m>]
--break-rewrites[=[<n>][/<m>]]

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

它影响了将完全重写文件的更改方式，不是作为一系列删除和插入混合在一起，其中只有极少数的行恰好在文本上与上下文匹配，而是作为删除所有旧内容，然后插入所有新内容，数字 <m> 控制 -B 选项的这方面（默认为 60%）。-B/70% 指定如果 Git 认为完全重写，则原始内容中剩余的部分应小于 30%（即，否则生成的补丁将是一系列删除和插入混合在一起，其中包含上下文行）。

与 -M 一起使用时，完全重写的文件也被认为是重命名的源（通常 -M 仅将消失的文件视为重命名的源），数字 <n> 控制 -B 选项的这方面（默认为 50%）。-B20% 指定与文件大小的 20% 或更多的添加和删除相比，可以挑选出更改作为可能重命名到另一个文件的源。

-M[<n>]
--find-renames[=<n>]

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

-C[<n>]
--find-copies[=<n>]

检测副本以及重命名。另请参见 --find-copies-harder。如果指定了 <n>，则其含义与 -M<n> 相同。

--find-copies-harder

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

-D
--irreversible-delete

省略删除的 preimage，即仅打印标头，而不打印 preimage 和 /dev/null 之间的差异。生成的补丁不适用于 patch 或 git apply；这仅适用于只想专注于查看更改后文本的人员。此外，输出显然缺乏足够的信息来反向应用这样的补丁，即使是手动应用，因此该选项的名称。

与 -B 一起使用时，也省略删除/创建对的删除部分中的 preimage。

-l<num>

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

--diff-filter=[(A|C|D|M|R|T|U|X|B)...[*]]

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

此外，这些大写字母可以小写以排除。例如，--diff-filter=ad 排除添加的和删除的路径。

请注意，并非所有差异都可以具有所有类型。例如，如果禁用对这些类型的检测，则不会出现复制和重命名的条目。

-S<string>

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

当您正在寻找一个精确的代码块（如结构体），并且想知道该代码块的历史记录时，它很有用：迭代地使用该功能将 preimage 中的有趣代码块反馈到 -S 中，并继续执行直到获得该代码块的第一个版本。

也会搜索二进制文件。

-G<regex>

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

为了说明 -S<regex>、--pickaxe-regex 和 -G<regex> 之间的区别，请考虑一个提交，该提交在同一文件中具有以下差异：

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

虽然 git log -G"frotz\(nitfol" 将显示此提交，但 git log -S"frotz\(nitfol" --pickaxe-regex 将不会（因为该字符串的出现次数没有改变）。

除非提供了 --text，否则将忽略没有 textconv 过滤器的二进制文件的补丁。

有关更多信息，请参阅 gitdiffcore[7] 中的 *pickaxe* 条目。

--find-object=<对象 ID>

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

该对象可以是 blob 或子模块提交。它暗示了 git-log 中的 -t 选项，以便也查找树。

--pickaxe-all

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

--pickaxe-regex

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

-O<顺序文件>

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

输出顺序由 *<顺序文件>* 中 glob 模式的顺序决定。 所有路径名与第一个模式匹配的文件首先输出，所有路径名与第二个模式匹配（但不与第一个匹配）的文件接下来输出，依此类推。 所有路径名与任何模式都不匹配的文件最后输出，就像文件的末尾有一个隐式的全部匹配模式。 如果多个路径名具有相同的等级（它们匹配相同的模式，但不匹配较早的模式），则它们相对于彼此的输出顺序是正常顺序。

*<顺序文件>* 的解析方式如下：

  • 空行将被忽略，因此它们可以用作可读性的分隔符。

  • 以哈希（"#"）开头的行将被忽略，因此它们可以用作注释。 如果模式以哈希开头，请在模式的开头添加反斜杠（"\"）。

  • 其他每一行都包含一个模式。

模式具有与用于 fnmatch(3) 的模式相同的语法和语义，没有 FNM_PATHNAME 标志，除非删除任意数量的最终路径名组件后与模式匹配，路径名也会与模式匹配。 例如，模式 "foo*bar" 匹配 "fooasdfbar" 和 "foo/bar/baz/asdf" 但不匹配 "foobarx"。

--skip-to=<文件>
--rotate-to=<文件>

从输出中丢弃指定 *<文件>* 之前的文件（即*跳到*），或者将它们移动到输出的末尾（即*旋转到*）。 这些选项主要用于 git difftool 命令，否则可能不是很有用。

-R

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

--relative[=<路径>]
--no-relative

从项目的子目录运行时，可以使用此选项排除目录之外的更改，并显示相对于该目录的路径名。 当您不在子目录中时（例如，在裸存储库中），您可以指定要将输出设置为相对于哪个子目录，方法是给出一个 *<path>* 作为参数。 --no-relative 可用于抵消 diff.relative 配置选项和之前的 --relative。

-a
--text

将所有文件视为文本。

--ignore-cr-at-eol

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

--ignore-space-at-eol

忽略行尾空格的更改。

-b
--ignore-space-change

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

-w
--ignore-all-space

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

--ignore-blank-lines

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

-I<regex>
--ignore-matching-lines=<regex>

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

--inter-hunk-context=<number>

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

-W
--function-context

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

--exit-code

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

--quiet

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

--ext-diff

允许执行外部差异帮助程序。 如果您使用 gitattributes[5] 设置了外部差异驱动程序，则需要在 git-log[1] 及其朋友中使用此选项。

--no-ext-diff

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

--textconv
--no-textconv

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

--ignore-submodules[=(none|untracked|dirty|all)]

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

--src-prefix=<前缀>

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

--dst-prefix=<前缀>

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

--no-prefix

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

--default-prefix

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

--line-prefix=<前缀>

将额外的 *<前缀>* 添加到输出的每一行。

--ita-invisible-in-index

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

有关这些常用选项的更详细说明，另请参阅 gitdiffcore[7]。

-1
--base
-2
--ours
-3
--theirs

将工作树与以下内容进行比较：

  • 使用 -1 或 --base 时的“base”版本（阶段 #1），

  • 使用 -2 或 --ours 时的“我们的分支”（阶段 #2），或

  • 使用 -3 或 --theirs 时的“他们的分支”（阶段 #3）。

索引仅包含未合并条目的这些阶段，即在解决冲突时。 有关详细信息，请参阅 git-read-tree[1] 部分“3-Way Merge”。

-0

省略未合并条目的差异输出，只显示“Unmerged”。 只能在将工作树与索引进行比较时使用。

<路径>...

当给出 <path> 参数时，它们用于将差异限制在指定的路径下（您可以给出目录名，并获取该目录下的所有文件的差异）。

原始输出格式

git-diff-index、git-diff-tree、git-diff-files 和 git diff --raw 的原始输出格式非常相似。

这些命令都会比较两组事物；比较的内容有所不同

git-diff-index <tree-ish>

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

git-diff-index --cached <tree-ish>

比较 <tree-ish> 和索引。

git-diff-tree [-r] <tree-ish-1> <tree-ish-2> [<pattern>...]

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

git-diff-files [<pattern>...]

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

git-diff-tree 命令首先打印正在比较的内容的哈希值。之后，所有命令都会为每个已更改的文件打印一行输出。

输出行的格式如下：

in-place edit  :100644 100644 bcd1234 0123456 M file0
copy-edit      :100644 100644 abcd123 1234567 C68 file1 file2
rename-edit    :100644 100644 abcd123 1234567 R86 file1 file3
create         :000000 100644 0000000 1234567 A file4
delete         :100644 000000 1234567 0000000 D file5
unmerged       :000000 000000 0000000 0000000 U file6

也就是，从左到右：

  1. 一个冒号。

  2. "src" 的模式；如果是创建或未合并，则为 000000。

  3. 一个空格。

  4. "dst" 的模式；如果是删除或未合并，则为 000000。

  5. 一个空格。

  6. "src" 的 sha1；如果是创建或未合并，则为 0{40}。

  7. 一个空格。

  8. "dst" 的 sha1；如果是删除、未合并或 "工作树与索引不同步"，则为 0{40}。

  9. 一个空格。

  10. 状态，后跟可选的 "score" 数字。

  11. 一个制表符或一个 NUL，当使用 -z 选项时。

  12. "src" 的路径

  13. 一个制表符或一个 NUL，当使用 -z 选项时；仅对于 C 或 R 存在。

  14. "dst" 的路径；仅对于 C 或 R 存在。

  15. 一个 LF 或一个 NUL，当使用 -z 选项时，用于终止记录。

可能的状态字母是：

  • A：添加一个文件

  • C：将一个文件复制到新文件中

  • D：删除一个文件

  • M：修改文件的内容或模式

  • R：重命名一个文件

  • T：更改文件的类型（常规文件、符号链接或子模块）

  • U：文件未合并（您必须先完成合并才能提交）

  • X："未知" 更改类型（很可能是一个 bug，请报告它）

状态字母 C 和 R 总是后跟一个分数（表示移动或复制的源和目标之间的相似度百分比）。状态字母 M 可能后跟一个分数（表示文件重写的相异度百分比）。

如果文件系统上的文件与索引不同步，则 "dst" 的 sha1 显示为全 0。

例子

:100644 100644 5be4a4a 0000000 M file.c

如果没有 -z 选项，具有 "不寻常" 字符的路径名将按照配置变量 core.quotePath 的说明进行引用（参见 git-config[1]）。 使用 -z 时，文件名将逐字输出，并且该行以 NUL 字节终止。

合并的差异格式

git-diff-tree、git-diff-files 和 git-diff --raw 可以使用 -c 或 --cc 选项来生成合并提交的差异输出。输出与上述格式的不同之处在于：

  1. 每个父级都有一个冒号

  2. 有更多的 "src" 模式和 "src" sha1

  3. 状态是每个父级的连接状态字符

  4. 没有可选的 "score" 数字

  5. 文件的制表符分隔的路径名

对于 -c 和 --cc，即使文件在历史记录的任何一侧被重命名，也只显示目标路径或最终路径。 使用 --combined-all-paths，显示每个父级中的路径名，后跟合并提交中的路径名。

-c 和 --cc 的示例，没有 --combined-all-paths

::100644 100644 100644 fabadb8 cc95eb0 4866510 MM	desc.c
::100755 100755 100755 52b7a2d 6d1ac04 d2ac7d7 RM	bar.sh
::100644 100644 100644 e07d6c5 9042e82 ee91881 RR	phooey.c

将 --combined-all-paths 添加到 -c 或 --cc 时的示例

::100644 100644 100644 fabadb8 cc95eb0 4866510 MM	desc.c	desc.c	desc.c
::100755 100755 100755 52b7a2d 6d1ac04 d2ac7d7 RM	foo.sh	bar.sh	bar.sh
::100644 100644 100644 e07d6c5 9042e82 ee91881 RR	fooey.c	fuey.c	phooey.c

请注意，组合差异仅列出从所有父级修改过的文件。

使用 -p 生成补丁文本

运行 git-diff[1]、git-log[1]、git-show[1]、git-diff-index[1]、git-diff-tree[1] 或 git-diff-files[1] 时，使用 -p 选项会生成补丁文本。 您可以通过 GIT_EXTERNAL_DIFF 和 GIT_DIFF_OPTS 环境变量（参见 git[1]）以及 diff 属性（参见 gitattributes[5]）自定义补丁文本的创建。

-p 选项产生的输出与传统的 diff 格式略有不同

  1. 它以一个 "git diff" 标头开头，如下所示：

    diff --git a/file1 b/file2

    除非涉及重命名/复制，否则 a/ 和 b/ 文件名是相同的。 特别是，即使对于创建或删除，也不会使用 /dev/null 代替 a/ 或 b/ 文件名。

    当涉及重命名/复制时，file1 和 file2 分别显示重命名/复制的源文件的名称和重命名/复制产生的文件名。

  2. 它后面跟着一个或多个扩展标头行：

    old mode <mode> new mode <mode> deleted file mode <mode> new file mode <mode> copy from <path> copy to <path> rename from <path> rename to <path> similarity index <number> dissimilarity index <number> index <hash>..<hash> <mode>

    文件模式 <mode> 以 6 位八进制数打印，包括文件类型和文件权限位。

    扩展标头中的路径名不包括 a/ 和 b/ 前缀。

    相似性索引是未更改行的百分比，相异性索引是已更改行的百分比。 它是一个四舍五入的整数，后跟一个百分号。 因此，100% 的相似性索引值保留给两个相等的文件，而 100% 的相异性意味着旧文件中没有一行进入新文件。

    索引行包括更改前后的 blob 对象名称。 如果文件模式没有更改，则包含 <mode>； 否则，单独的行指示旧模式和新模式。

  3. 具有 "不寻常" 字符的路径名将按照配置变量 core.quotePath 的说明进行引用（参见 git-config[1]）。

  4. 输出中的所有 file1 文件都引用提交之前的文件，而所有 file2 文件都引用提交之后的文件。 依次将每个更改应用于每个文件是不正确的。 例如，此补丁将交换 a 和 b

    diff --git a/a b/b
rename from a
rename to b
diff --git a/b b/a
rename from b
rename to a

  5. Hunk 标头提及应用该 hunk 的函数的名称。 有关如何根据特定语言定制此标头的详细信息，请参见 gitattributes[5] 中的 "定义自定义 hunk 标头"。

组合差异格式

任何生成差异的命令都可以使用 -c 或 --cc 选项来生成 组合差异，以显示合并。 这是使用 git-diff[1] 或 git-show[1] 显示合并时的默认格式。 另请注意，您可以为这些命令提供合适的 --diff-merges 选项，以强制以特定格式生成差异。

"组合差异" 格式如下所示：

diff --combined describe.c
index fabadb8,cc95eb0..4866510
--- a/describe.c
+++ b/describe.c
@@@ -98,20 -98,12 +98,20 @@@
	return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1;
  }

- static void describe(char *arg)
 -static void describe(struct commit *cmit, int last_one)
++static void describe(char *arg, int last_one)
  {
 +	unsigned char sha1[20];
 +	struct commit *cmit;
	struct commit_list *list;
	static int initialized = 0;
	struct commit_name *n;

 +	if (get_sha1(arg, sha1) < 0)
 +		usage(describe_usage);
 +	cmit = lookup_commit_reference(sha1);
 +	if (!cmit)
 +		usage(describe_usage);
 +
	if (!initialized) {
		initialized = 1;
		for_each_ref(get_name);

  1. 它前面有一个 "git diff" 标头，如下所示（当使用 -c 选项时）：

    diff --combined file

    或如下所示（当使用 --cc 选项时）：

    diff --cc file

  2. 它后面跟着一个或多个扩展标头行（此示例显示了一个具有两个父级的合并）：

    index <hash>,<hash>..<hash> mode <mode>,<mode>..<mode> new file mode <mode> deleted file mode <mode>,<mode>

    只有当至少一个 <mode> 与其余 <mode> 不同时，才会出现 mode <mode>,<mode>..<mode> 行。 带有关于检测到的内容移动（重命名和复制检测）信息的扩展标头旨在与两个 <tree-ish> 的差异一起使用，并且不被组合差异格式使用。

  3. 它后面跟着一个两行的 from-file/to-file 标头：

    --- a/file
+++ b/file

    类似于传统的 unified diff 格式的两行标头，/dev/null 用于表示创建或删除的文件。

    但是，如果提供了 --combined-all-paths 选项，则您将获得一个 N+1 行的 from-file/to-file 标头，而不是一个两行的 from-file/to-file 标头，其中 N 是合并提交中父级的数量：

    --- a/file
--- a/file
--- a/file
+++ b/file

    如果重命名或复制检测处于活动状态，则此扩展格式可能很有用，以便您可以查看文件中不同父级中的原始名称。

  4. Chunk 标头格式已修改，以防止人们意外地将其提供给 patch -p1。 创建组合差异格式是为了审查合并提交更改，而不是要应用它。 此更改类似于扩展的 index 标头中的更改。

    @@@ <from-file-range> <from-file-range> <to-file-range> @@@

    组合差异格式的 chunk 标头中有（父级的数量 + 1）个 @ 字符。

与传统的 unified diff 格式不同，传统的 unified diff 格式显示两个文件 A 和 B，它们具有一个单列，其中有 -（减号 — 出现在 A 中但在 B 中删除）、+（加号 — A 中缺少但在 B 中添加）或 " "（空格 — 未更改）前缀，此格式将两个或多个文件 file1、file2,…​与一个文件 X 进行比较，并显示 X 与每个 fileN 的不同之处。 每个 fileN 的一列都预先添加到输出行中，以记录 X 的行与它的不同之处。

列 N 中的 - 字符表示该行出现在 fileN 中，但不出现在结果中。 列 N 中的 + 字符表示该行出现在结果中，并且 fileN 没有该行（换句话说，从该父级的角度来看，该行被添加了）。

在上面的示例输出中，函数签名从两个文件中都发生了更改（因此从 file1 和 file2 中都删除了两个 -，再加上 ++ 表示添加的一行未出现在 file1 或 file2 中）。 此外，来自 file1 的八行其他行相同，但未出现在 file2 中（因此以 + 作为前缀）。

当由 git diff-tree -c 显示时，它会将合并提交的父级与合并结果进行比较（即 file1..fileN 是父级）。 当由 git diff-files -c 显示时，它会将两个未解决的合并父级与工作树文件进行比较（即 file1 是阶段 2，也称为 "我们的版本"，file2 是阶段 3，也称为 "他们的版本"）。

其他差异格式

--summary 选项描述了新添加、删除、重命名和复制的文件。 --stat 选项将 diffstat(1) 图添加到输出中。 这些选项可以与其他选项（例如 -p）组合使用，并且旨在供人使用。

当显示涉及重命名或复制的更改时，--stat 输出通过组合路径名的常见前缀和后缀来紧凑地格式化路径名。 例如，将 arch/i386/Makefile 移动到 arch/x86/Makefile 并修改 4 行的更改将显示如下：

arch/{i386 => x86}/Makefile    |   4 +--

--numstat 选项提供 diffstat(1) 信息，但设计用于更轻松的机器消费。 --numstat 输出中的条目如下所示：

1	2	README
3	1	arch/{i386 => x86}/Makefile

也就是，从左到右：

  1. 添加的行数；

  2. 一个制表符；

  3. 删除的行数；

  4. 一个制表符；

  5. 路径名（可能带有重命名/复制信息）；

  6. 一个换行符。

当 -z 输出选项生效时，输出的格式如下：

1	2	README NUL
3	1	NUL arch/i386/Makefile NUL arch/x86/Makefile NUL

也就是：

  1. 添加的行数；

  2. 一个制表符；

  3. 删除的行数；

  4. 一个制表符；

  5. 一个 NUL（仅在重命名/复制时存在）；

  6. preimage 中的路径名；

  7. 一个 NUL（仅在重命名/复制时存在）；

  8. postimage 中的路径名（仅在重命名/复制时存在）；

  9. 一个 NUL。

在重命名情况下，preimage 路径之前的额外 NUL 允许读取输出的脚本判断当前读取的记录是单路径记录还是重命名/复制记录，而无需提前读取。在读取添加和删除的行后，读取到 NUL 将产生路径名，但如果该路径名是 NUL，则该记录将显示两个路径。

示例

检查工作区的各种方法
$ git diff            (1)
$ git diff --cached   (2)
$ git diff HEAD       (3)
$ git diff AUTO_MERGE (4)

  1. 工作区中尚未暂存以备下次提交的更改。

  2. 索引和上次提交之间的更改；如果您在没有 -a 选项的情况下运行 git commit，您将提交的内容。

  3. 自上次提交以来工作区中的更改；如果您运行 git commit -a，您将提交的内容。

  4. 您为解决文本冲突而对工作区所做的更改。

与任意提交比较
$ git diff test            (1)
$ git diff HEAD -- ./test  (2)
$ git diff HEAD^ HEAD      (3)

  1. 不使用当前分支的尖端，而是与 "test" 分支的尖端进行比较。

  2. 不与 "test" 分支的尖端进行比较，而是与当前分支的尖端进行比较，但将比较限制在文件 "test" 上。

  3. 比较上一次提交之前的版本和上一次提交。

比较分支
$ git diff topic master    (1)
$ git diff topic..master   (2)
$ git diff topic...master  (3)

  1. topic 和 master 分支尖端之间的更改。

  2. 与上述相同。

  3. 自 topic 分支从 master 分支分叉后，master 分支上发生的更改。

限制 diff 输出
$ git diff --diff-filter=MRC            (1)
$ git diff --name-status                (2)
$ git diff arch/i386 include/asm-i386   (3)

  1. 仅显示修改、重命名和复制，但不显示添加或删除。

  2. 仅显示名称和更改的性质，而不显示实际的 diff 输出。

  3. 将 diff 输出限制为命名的子树。

整理 diff 输出
$ git diff --find-copies-harder -B -C  (1)
$ git diff -R                          (2)

  1. 花费额外的周期来查找重命名、复制和完全重写（非常昂贵）。

  2. 以相反的顺序输出 diff。

配置

本节中此行下面的所有内容均有选择地包含在 git-config[1] 文档中。 内容与那里找到的内容相同

diff.autoRefreshIndex

当使用 git diff 与工作区文件进行比较时，不要将仅 stat 更改视为已更改。 而是，静默运行 git update-index --refresh 以更新工作区中内容与索引中内容匹配的路径的缓存 stat 信息。 此选项默认为 true。 请注意，这仅影响 git diff 瓷器（Porcelain），而不影响较低级别的 diff 命令，例如 git diff-files。

diff.dirstat

一个逗号分隔的 --dirstat 参数列表，用于指定 git diff 及其相关命令的 --dirstat 选项的默认行为。 可以在命令行上覆盖默认值（使用 --dirstat=<param>,...）。 后备默认值（当未被 diff.dirstat 更改时）为 changes,noncumulative,3。 以下参数可用

changes

通过计算从源中删除或添加到目标中的行来计算 dirstat 数字。 这忽略了文件中纯代码移动的数量。 换句话说，重新排列文件中的行不像其他更改那样被计数。 这是未给出参数时的默认行为。

lines

通过执行常规的基于行的差异分析，并对删除/添加的行数进行求和来计算 dirstat 数字。 （对于二进制文件，计算 64 字节的块，因为二进制文件没有行的自然概念）。 这是一种比 changes 行为更昂贵的 --dirstat 行为，但它会像其他更改一样计算文件中的重新排列行。 生成的输出与您从其他 --*stat 选项中获得的结果一致。

files

通过计算已更改文件的数量来计算 dirstat 数字。 每个已更改的文件在 dirstat 分析中都同样计数。 这是计算成本最低的 --dirstat 行为，因为它根本不必查看文件内容。

cumulative

计算父目录中子目录的更改。 请注意，当使用 cumulative 时，报告的百分比之和可能超过 100%。 默认（非累积）行为可以使用 noncumulative 参数指定。

<limit>

整数参数指定一个截止百分比（默认为 3%）。 贡献小于此百分比的更改的目录不会显示在输出中。

示例：以下将计算已更改的文件，同时忽略已更改文件总数不到 10% 的目录，并在父目录中累积子目录计数：files,10,cumulative。

diff.statNameWidth

限制 --stat 输出中文件名部分的宽度。 如果设置，则适用于生成 --stat 输出的所有命令，除了 format-patch。

diff.statGraphWidth

限制 --stat 输出中图形部分的宽度。 如果设置，则适用于生成 --stat 输出的所有命令，除了 format-patch。

diff.context

生成带有 <n> 行上下文的 diff，而不是默认的 3 行。 此值被 -U 选项覆盖。

diff.interHunkContext

显示 diff 块之间的上下文，最多为指定的行数，从而融合彼此靠近的块。 此值用作 --inter-hunk-context 命令行选项的默认值。

diff.external

如果设置了此配置变量，则不使用内部 diff 机制执行 diff 生成，而是使用给定的命令。 可以使用 GIT_EXTERNAL_DIFF 环境变量覆盖。 该命令使用 git[1] 中“git Diffs”下描述的参数调用。 注意：如果您只想在文件的子集上使用外部 diff 程序，您可能需要使用 gitattributes[5] 代替。

diff.trustExitCode

如果此布尔值设置为 true，则期望 diff.external 命令在认为输入文件相等时返回退出代码 0，而在认为它们不同时返回 1，如 diff(1)。 如果设置为 false（默认值），则期望该命令无论是否相等都返回退出代码 0。 任何其他退出代码都会导致 Git 报告致命错误。

diff.ignoreSubmodules

设置 --ignore-submodules 的默认值。 请注意，这仅影响 git diff 瓷器（Porcelain），而不影响较低级别的 diff 命令，例如 git diff-files。 当报告未提交的更改时，git checkout 和 git switch 也会遵守此设置。 将其设置为 all 将禁用 git commit 和 git status 通常显示的子模块摘要（当设置了 status.submoduleSummary 时），除非使用 --ignore-submodules 命令行选项覆盖它。 git submodule 命令不受此设置的影响。 默认情况下，此值设置为 untracked，以便忽略任何未跟踪的子模块。

diff.mnemonicPrefix

如果设置，git diff 使用与标准 a/ 和 b/ 不同的前缀对，具体取决于比较的内容。 当此配置生效时，反向 diff 输出也会交换前缀的顺序

git diff

比较 (i)ndex 和 (w)ork tree；

git diff HEAD

比较 (c)ommit 和 (w)ork tree；

git diff --cached

比较 (c)ommit 和 (i)ndex；

git diff HEAD:<file1> <file2>

比较 (o)bject 和 (w)ork tree 实体；

git diff --no-index <a> <b>

比较两个非 git 事物 <a> 和 <b>。

diff.noPrefix

如果设置，git diff 不显示任何源或目标前缀。

diff.srcPrefix

如果设置，git diff 使用此源前缀。 默认为 a/。

diff.dstPrefix

如果设置，git diff 使用此目标前缀。 默认为 b/。

diff.relative

如果设置为 true，git diff 不显示目录之外的更改，并显示相对于当前目录的路径名。

diff.orderFile

指示如何在 diff 中对文件进行排序的文件。 有关详细信息，请参见 -O 选项。 如果 diff.orderFile 是相对路径名，则将其视为相对于工作树的顶部。

diff.renameLimit

在复制/重命名检测的穷举部分中要考虑的文件数； 等效于 git diff 选项 -l。 如果未设置，则默认值当前为 1000。 如果关闭了重命名检测，则此设置无效。

diff.renames

Git 是否以及如何检测重命名。 如果设置为 false，则禁用重命名检测。 如果设置为 true，则启用基本重命名检测。 如果设置为 copies 或 copy，Git 也会检测复制。 默认为 true。 请注意，这仅影响 git diff 瓷器（Porcelain），例如 git-diff[1] 和 git-log[1]，而不影响较低级别的命令，例如 git-diff-files[1]。

diff.suppressBlankEmpty

一个布尔值，用于禁止在每个空输出行之前打印空格的标准行为。 默认为 false。

diff.submodule

指定显示子模块差异的格式。 short 格式仅显示范围开始和结束处的提交的名称。 log 格式列出范围内的提交，如 git-submodule[1] summary 所做的那样。 diff 格式显示子模块更改内容的内联差异。 默认为 short。

diff.wordRegex

一个 POSIX 扩展正则表达式，用于确定在执行逐字差异计算时什么是“单词”。 与正则表达式匹配的字符序列是“单词”，所有其他字符都是可忽略的空格。

diff.<driver>.command

自定义的diff驱动命令。 详情请参阅 gitattributes[5]。

diff.<driver>.trustExitCode

如果这个布尔值设置为 true，那么 diff.<driver>.command 命令在认为输入文件相同时应返回退出码 0，在认为输入文件不同时应返回退出码 1，就像 diff(1) 一样。如果设置为 false （默认值），则无论是否相等，命令都应返回退出码 0。任何其他退出码都会导致 Git 报告致命错误。

diff.<driver>.xfuncname

diff驱动应该用来识别hunk header的正则表达式。 也可以使用内置模式。 详情请参阅 gitattributes[5]。

diff.<driver>.binary

将此选项设置为 true 以使diff驱动将文件视为二进制文件。 详情请参阅 gitattributes[5]。

diff.<driver>.textconv

diff驱动应该调用的命令，用于生成文件的文本转换版本。 转换结果用于生成人类可读的差异。 详情请参阅 gitattributes[5]。

diff.<driver>.wordRegex

diff驱动应该用来分割一行中单词的正则表达式。 详情请参阅 gitattributes[5]。

diff.<driver>.cachetextconv

将此选项设置为 true 以使diff驱动缓存文本转换输出。 详情请参阅 gitattributes[5]。

diff.indentHeuristic

将此选项设置为 false 以禁用默认的启发式算法，该算法会移动diff hunk边界以使补丁更易于阅读。

diff.algorithm

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

default
myers

基本贪婪差异算法。目前，这是默认设置。

minimal

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

patience

在生成补丁时使用 “耐心差异” 算法。

histogram

此算法扩展了耐心算法以“支持低频常见元素”。

diff.wsErrorHighlight

突出显示差异的 context，old 或 new 行中的空格错误。多个值用逗号分隔，none 重置先前的值，default 将列表重置为 new，而 all 是 old,new,context 的简写。空格错误使用 color.diff.whitespace 着色。 命令行选项 --ws-error-highlight=<kind> 覆盖此设置。

diff.colorMoved

如果设置为有效的<mode>或true值，则差异中移动的行将被着色为不同的颜色。 有关有效模式的详细信息，请参见--color-moved。如果仅设置为true，则将使用默认颜色模式。如果设置为false，则不会对移动的行进行着色。

diff.colorMovedWS

当使用例如diff.colorMoved设置对移动的行进行着色时，此选项控制处理空格的模式。 有关有效模式的详细信息，请参见git-diff[1]中的--color-moved-ws。

参见

diff(1), git-difftool[1], git-log[1], gitdiffcore[7], git-format-patch[1], git-apply[1], git-show[1]

GIT

属于 git[1] 套件的一部分

scroll-to-top