# git-diff
> 原文： [https://git-scm.com/docs/git-diff](https://git-scm.com/docs/git-diff)
>
> 贡献者：[honglyua](https://github.com/honglyua)
## 名称
git-diff - 显示提交之前，提交和工作树之间的更改等
## 概要
```
git diff [<options>] [<commit>] [--] [<path>…]
git diff [<options>] --cached [<commit>] [--] [<path>…]
git diff [<options>] <commit> <commit> [--] [<path>…]
git diff [<options>] <blob> <blob>
git diff [<options>] --no-index [--] <path> <path>
```
## 描述
显示工作树与索引或树之间的更改，索引与树之间的更改，两个树之间的更改，两个blob对象之间的更改或磁盘上两个文件之间的更改。
```
git diff [<options>] [--] [<path>…]
```
此表单用于查看您相对于索引所做的更改（下一次提交的暂存区域）。换句话说，差异就是你 _可以_ 告诉Git即将要添加，但还没有添加到索引的内容。您可以使用 [git-add [1]](https://git-scm.com/docs/git-add) 暂存这些更改。
```
git diff [<options>] --no-index [--] <path> <path>
```
此表单用于比较文件系统上给定的两个路径。在由Git控制的工作树中运行命令时，可以省略`--no-index`选项，并且至少有一个路径指向工作树外部，或者在Git控制的工作树外运行命令。
```
git diff [<options>] --cached [<commit>] [--] [<path>…]
```
此表单用于查看您为下一次提交而暂存的内容与已经<commit>的内容之间的更改。通常，您希望与最新提交进行比较，因此如果您不提供<commit>，则默认为HEAD。如果HEAD不存在（例如未出生的分支）并且<commit>没有给出，它将显示所有暂存的更改。--staged是--cached的同义词。
```
git diff [<options>] <commit> [--] [<path>…]
```
此表单用于查看工作树中相对于已经提交<commit>的更改。您可以使用HEAD将其与最新提交进行比较，或使用分支名称与其他分支的提示进行比较。
```
git diff [<options>] <commit> <commit> [--] [<path>…]
```
这是为了查看两个任意<commit>之间的更改。
```
git diff [<options>] <commit>..<commit> [--] [<path>…]
```
这与之前的表格同义。如果<commit>在一侧被省略，它将具有与使用HEAD相同的效果。
```
git diff [<options>] <commit>...<commit> [--] [<path>…]
```
此表单用于查看分支上的更改，从两个<commit>的共同祖先开始，包含第二个<commit>及以上的节点。 “git diff A ... B”相当于“git diff $(git merge-base A B）B”。您可以省略<commit>中的任何一个，它与使用HEAD具有相同的效果。
如果你正在做一些特殊操作，应该注意在上面描述中的所有<commit>，除了使用“..”符号的最后两种形式之外，可以是任何<tree>。
有关拼写<commit>的更完整列表的详细列表，请参阅 [gitrevisions [7]](https://git-scm.com/docs/gitrevisions) 中的“指定修订”部分。然而，“diff”是关于比较两个 _端点_，而不是范围和范围符号（“<commit>..<commit>”和“<commit> ...<commit> “）并不是指 [gitrevisions [7]](https://git-scm.com/docs/gitrevisions) 中”指定范围“部分中定义的范围。
```
git diff [<options>] <blob> <blob>
```
此表单用于查看两个blob对象的原始内容之间的差异。
## 选项
```
-p
```
```
-u
```
```
--patch
```
生成补丁（请参阅生成补丁的部分）。这是默认值。
```
-s
```
```
--no-patch
```
抑制差异输出。对于`git show`等默认显示补丁的命令，或取消`--patch`的效果很有用。
```
-U<n>
```
```
--unified=<n>
```
生成<n>行的上下文差异。而不是通常的三行。意味着`--patch`或`-p`。
```
--output=<file>
```
输出到指定文件汇总，而不是标准输出中。
```
--output-indicator-new=<char>
```
```
--output-indicator-old=<char>
```
```
--output-indicator-context=<char>
```
在生成补丁时，用特殊字符表明哪些行时new，old，context。通常是用 +, - and ' '。
```
--raw
```
以原始格式生成diff。
```
--patch-with-raw
```
`-p --raw`的同义词。
```
--indent-heuristic
```
启用改变差异块边界的启发式以使补丁更易于阅读。这是默认值。
```
--no-indent-heuristic
```
禁用缩进启发式。
```
--minimal
```
花些额外的时间来确保产生尽可能小的差异。
```
--patience
```
使用“patience diff”算法生成差异。
```
--histogram
```
使用“histogram diff”算法生成差异。
```
--anchored=<text>
```
使用“anchored diff”算法生成差异。
可以多次指定此选项。
如果源和目标中都存在一行，只存在一次，并以此文本开头，则此算法会尝试阻止它在输出中显示为删除或添加。它在内部使用“patience diff”算法。
```
--diff-algorithm={patience|minimal|histogram|myers}
```
选择差异算法。变体如下：
```
default, myers
```
基本的贪心差异算法。目前，这是默认值。
```
minimal
```
花些额外的时间来确保产生尽可能小的差异。
```
patience
```
生成补丁时使用“patience diff”算法。
```
histogram
```
该算法将”patience diff“算法扩展为“支持低发生的共同元素”。
例如，如果将`diff.algorithm`变量配置为非默认值并想要使用默认值，则必须使用`--diff-algorithm=default`选项。
```
--stat[=<width>[,<name-width>[,<count>]]]
```
生成diffstat。默认情况下，文件名部分，图形部分的其余部分将使用必要的空间。最大宽度默认为终端宽度，如果未连接到终端，则为80列，并且可以被`<width>`覆盖。可以通过在逗号后面给出另一个宽度`<name-width>`来限制文件名部分的宽度。可以使用`--stat-graph-width=<width>`（影响生成统计图的所有命令）或设置`diff.statGraphWidth=<width>`（不影响`git format-patch`）来限制图形部分的宽度。通过给出第三个参数`<count>`，可以将输出限制为第一个`<count>`行，如果有更多，则将以`...`表示。
也可以使用`--stat-width=<width>`，`--stat-name-width=<name-width>`和`--stat-count=<count>`单独设置这些参数。
```
--compact-summary
```
输出扩展标题信息的精简摘要，例如文件创建或删除（“新建”或“消失”，如果是符号链接，则可选“+l”）和文件权限更改（“+x”或“-x”用于添加或删除diffstat中的可执行位）。信息放在文件名部分和图形部分之间。意味着`--stat`。
```
--numstat
```
与`--stat`类似，但是为了更加友好，它用十进制显示添加和删除的行数以及没有缩写的路径名。对于二进制文件，输出两个`-`而不是`0 0`。
```
--shortstat
```
仅输出`--stat`格式的最后一行，其中包含已修改文件的总数，以及已添加和已删除行的总数。
```
-X[<param1,param2,…>]
```
```
--dirstat[=<param1,param2,…>]
```
输出每个子目录的相对更改量的分布。 `--dirstat`的行为可以通过以逗号分隔的参数列表传递来定制。默认值由`diff.dirstat`配置变量控制（参见 [git-config [1]](https://git-scm.com/docs/git-config) ）。可以使用以下参数：
```
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[=<param1,param2>…]
```
与--dirstat=files,param1,param2…相同
```
--summary
```
输出扩展标题信息的精简摘要，例如创建，重命名和模式更改。
```
--patch-with-stat
```
与`-p --stat`相同。
```
-z
```
当给出`--raw`，`--numstat`，`--name-only`或`--name-status`时，不使用路径名和NUL作为输出字段终止符。
如果没有此选项，则会引用具有“异常”字符的路径名，如配置变量`core.quotePath`所述（参见 [git-config [1]](https://git-scm.com/docs/git-config) ）。
```
--name-only
```
仅显示已更改文件的名称。
```
--name-status
```
仅显示已更改文件的名称和状态。有关状态字母的含义，请参阅`--diff-filter`选项的说明。
```
--submodule[=<format>]
```
指定子模块的差异如何显示。当指定`--submodule=short`时，使用 _short_ 格式。此格式仅显示范围开头和结尾的提交名称。当指定`--submodule`或`--submodule=log`时，使用 _log_ 格式。此格式列出所有commits的提交，类似[git-submodule [1]](https://git-scm.com/docs/git-submodule) 中`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_ 将用于在diff中的其他位置添加的已删除行。此模式选择任何已移动的行，但在检查中确定是否在没有置换的情况下移动了代码块时，它不是很有用。
```
blocks
```
贪婪地检测至少20个字母数字字符的移动文本块。使用 _color.diff.{old，new} Moved_ 颜色绘制检测到的块。相邻的块不能分开。
```
zebra
```
在 _block_ 模式中检测移动文本块。使用 _color.diff.{old，new} Moved_ 颜色或 _color.diff.{old，new} MovedAlternative_ 绘制块。两种颜色之间的变化表示检测到新的块。
```
dimmed-zebra
```
与 _zebra_ 类似，但表现为额外调暗了移动代码的无趣部分。两个相邻块的边界线被认为是有趣的，其余的是无趣的。不推荐使用同义词`dimmed_zebra`。
```
--no-color-moved
```
关闭移动检测。这可用于覆盖配置设置。它与`--color-moved=no`相同。
```
--color-moved-ws=<modes>
```
这将配置在执行`--color-moved`的移动检测时如何忽略空白。可以通过`diff.colorMovedWS`配置设置进行设置。这些模式可以以逗号分隔的列表给出：
```
no
```
执行移动检测时不要忽略空格。
```
ignore-space-at-eol
```
忽略EOL中的空白更改。
```
ignore-space-change
```
忽略空格量的变化。这会忽略行尾的空格，并将一个或多个空白字符的所有其他序列视为等效。
```
ignore-all-space
```
比较线条时忽略空格。即使一行有空格而另一行没有空格，这也会忽略差异。
```
allow-indentation-change
```
最初忽略移动检测中的任何空格，然后如果每行的空白变化相同，则仅将移动的代码块分组到块中。这与其他模式不兼容。
```
--no-color-moved-ws
```
执行移动检测时不要忽略空格。这可用于覆盖配置设置。它与`--color-moved-ws=no`相同。
```
--word-diff[=<mode>]
```
使用< mode>显示单词diff。划定改变的单词。默认情况下，单词由空格分隔;见下面的`--word-diff-regex`。 <mode>默认为 _plain_ ，或者是以下之一：
```
color
```
仅使用颜色突出显示更改的单词。意味着`--color`。
```
plain
```
将单词显示为`[-removed-]`和`{+added+}`。如果它们出现在输入中，则不会尝试转义分隔符，因此输出可能不明确。
```
porcelain
```
使用特殊的基于行的格式用于脚本使用。添加/删除/未更改的运行以通常的统一diff格式打印，从行开头的`+` / `-` /``字符开始并延伸到行尾。输入中的换行符由其自身行上的波浪号`~`表示。
```
none
```
再次禁用字差异。
请注意，如果启用了颜色，在所有模式中将使用第一个模式的名称，颜色突出显示已更改的部分。
```
--word-diff-regex=<regex>
```
使用<regex>决定一个单词是什么，而不是将非空格的运行视为一个单词。除非已经启用，否则还暗示`--word-diff`。
<regex>的每个非重叠匹配被认为是一个词。这些匹配之间的任何内容都被视为空格并被忽略（!）以查找差异。您可能希望将`|[^[:space:]]`附加到正则表达式，以确保它匹配所有非空白字符。包含换行符的匹配项会在换行符处以静默方式截断（!）。
例如，`--word-diff-regex=.`会将每个字符视为一个单词，并相应地逐个字符地显示差异。
正则表达式也可以通过diff驱动程序或配置选项设置，参见 [gitattributes [5]](https://git-scm.com/docs/gitattributes) 或 [git-config [1]](https://git-scm.com/docs/git-config) 。明确地覆盖任何差异驱动程序或配置设置。 Diff驱动程序覆盖配置设置。
```
--color-words[=<regex>]
```
相当于`--word-diff=color`加（如果指定了正则表达式）`--word-diff-regex=<regex>`。
```
--no-renames
```
关闭重命名检测，即使配置文件提供默认值也是如此。
```
--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
```
在生成补丁格式输出时，在“索引”行上显示完整的前映像和后映像blob对象名称，而不是第一个字符。
```
--binary
```
除`--full-index`外，还可输出可用`git-apply`输出二进制差异，`--patch`也可以。
```
--abbrev[=<n>]
```
不是在diff-raw格式输出和diff-tree标题行中显示完整的40字节十六进制对象名称，而是仅显示部分前缀。这与上面的`--full-index`选项无关，后者控制diff-patch输出格式。可以使用`--abbrev=<n>`指定非默认位数。
```
-B[<n>][/<m>]
```
```
--break-rewrites[=[<n>][/<m>]]
```
将完整的重写更改分为删除和创建对。这有两个目的：
它影响了一个更改的方式，相当于一个文件的完全重写，而不是一系列的删除和插入混合在一起，只有几行恰好与文本作为上下文匹配，而是作为单个删除所有旧的后跟一个单个插入所有新内容，数字`m`控制-B选项的这一方面（默认为60％）。 `-B/70%`指定少于30％的原始文本应保留在结果中，以便Git将其视为完全重写（即，否则生成的修补程序将是一系列删除和插入与上下文行混合在一起）。
当与-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
```
省略删除的原像，即只打印标题而不打印原像和`/dev/null`之间的差异。得到的patch不适用于`patch`或`git apply`;这仅适用于那些希望在更改后专注于检视文本的人。此外，输出显然缺乏足够的信息来反向应用这样的补丁，甚至手动，因此选项的名称。
与`-B`一起使用时，也省略删除/创建对的删除部分中的原像。
```
-l<num>
```
`-M`和`-C`选项需要O（n^2）处理时间，其中n是潜在的重命名/复制目标的数量。如果重命名/复制目标的数量超过指定的数量，此选项可防止重命名/复制检测运行。
```
--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>
```
查找改变文件中指定字符串出现次数（即添加/删除）的差异。用于脚本编写者的使用。
当你正在寻找一个确切的代码块（比如一个结构体）时，它很有用，并且想要知道该块首次出现以来的历史：迭代地使用该特征将原始图像中的有趣块反馈回`-S`，继续前进，直到你获得该块的第一个版本。
也可以搜索二进制文件。
```
-G<regex>
```
查找补丁文本包含与<regex>匹配的添加/删除行的差异。
为了说明`-S<regex> --pickaxe-regex`和`-G<regex>`之间的区别，请考虑在同一文件中使用以下diff进行提交：
```
+ return !regexec(regexp, two->ptr, 1, ®match, 0);
...
- hit = !regexec(regexp, mf2.ptr, 1, ®match, 0);
```
虽然`git log -G"regexec\(regexp"`将显示此提交，但`git log -S"regexec\(regexp" --pickaxe-regex`不会（因为该字符串的出现次数没有改变）。
除非提供`--text`，否则将忽略没有textconv过滤器的二进制文件的补丁。
有关详细信息，请参阅 [gitdiffcore [7]](https://git-scm.com/docs/gitdiffcore) 中的 _pickaxe_ 条目。
```
--find-object=<object-id>
```
查找更改指定对象出现次数的差异。与`-S`类似，只是参数的不同之处在于它不搜索特定的字符串，而是搜索特定的对象id。
该对象可以是blob或子模块提交。它意味着`git-log`中的`-t`选项也可以找到树。
```
--pickaxe-all
```
当`-S`或`-G`找到更改时，显示该更改集中的所有更改，而不仅仅是包含< string>中更改的文件。
```
--pickaxe-regex
```
对待< string>赋予`-S`作为扩展的POSIX正则表达式以匹配。
```
-O<orderfile>
```
控制文件在输出中的显示顺序。这会覆盖`diff.orderFile`配置变量（参见 [git-config [1]](https://git-scm.com/docs/git-config) ）。要取消`diff.orderFile`，请使用`-O/dev/null`。
输出顺序由< orderfile>中的glob模式的顺序决定。首先输出所有与第一个模式匹配的路径名的文件，然后输出所有与第二个模式（但不是第一个模式）匹配的路径名的文件，依此类推。路径名与任何模式都不匹配的所有文件都是最后输出的，就好像文件末尾有一个隐式匹配所有模式一样。如果多个路径名具有相同的等级（它们匹配相同的模式但没有早期模式），则它们相对于彼此的输出顺序是正常顺序。
<orderfile>解析如下：
* 空行被忽略，因此可以将它们用作分隔符以提高可读性。
* 以哈希（“`#`”）开头的行将被忽略，因此它们可用于注释。如果以哈希开头，则将反斜杠（“`\`”）添加到模式的开头。
* 每个其他行包含一个模式。
模式与没有FNM_PATHNAME标志的fnmatch（3）使用模式具有相同的语法和语义，除匹配的路径名之外，如果删除任意数量的与模式匹配的最终路径名组件。例如，模式“`foo*bar`”匹配“`fooasdfbar`”和“`foo/bar/baz/asdf`”而不匹配“`foobarx`”。
```
-R
```
交换两个输入;也就是说，显示从索引或磁盘文件到树内容的差异。
```
--relative[=<path>]
```
从项目的子目录运行时，可以告诉它除目录外的更改并使用此选项显示相对于它的路径名。当您不在子目录中时（例如，在裸存储库中），您可以通过给出<path>作为一个参数来命名哪个子目录以使输出相对。
```
-a
```
```
--text
```
将所有文件视为文本。
```
--ignore-cr-at-eol
```
进行比较时，忽略行尾的回车。
```
--ignore-space-at-eol
```
忽略EOL中的空白更改。
```
-b
```
```
--ignore-space-change
```
忽略空格量的变化。这会忽略行尾的空格，并将一个或多个空白字符的所有其他序列视为等效。
```
-w
```
```
--ignore-all-space
```
比较线条时忽略空格。即使一行有空格而另一行没有空格，这也会忽略差异。
```
--ignore-blank-lines
```
忽略其行全部为空的更改。
```
--inter-hunk-context=<lines>
```
显示差异之间的上下文，直到指定的行数，从而融合彼此接近的内容。如果未设置配置选项，则默认为`diff.interHunkContext`或0。
```
-W
```
```
--function-context
```
显示整个周围的变化功能。
```
--exit-code
```
使用类似于diff（1）的代码退出程序。也就是说，如果存在差异则退出1，0表示没有差异。
```
--quiet
```
禁用程序的所有输出。意味着`--exit-code`。
```
--ext-diff
```
允许执行外部diff助手。如果使用 [gitattributes [5]](https://git-scm.com/docs/gitattributes) 设置外部差异驱动程序，则需要将此选项与 [git-log [1]](https://git-scm.com/docs/git-log) 一起友好使用。
```
--no-ext-diff
```
禁止外部差异驱动程序。
```
--textconv
```
```
--no-textconv
```
在比较二进制文件时允许（或禁止）外部文本转换过滤器运行。有关详细信息，请参阅 [gitattributes [5]](https://git-scm.com/docs/gitattributes) 。由于textconv过滤器通常是单向转换，因此生成的差异适合人阅读，但无法应用。因此，默认情况下，textconv过滤器仅针对 [git-diff [1]](https://git-scm.com/docs/git-diff) 和 [git-log [1]](https://git-scm.com/docs/git-log) 启用，但不适用于 [git-format-patch [ 1]](https://git-scm.com/docs/git-format-patch) 或差异管道命令。
```
--ignore-submodules[=<when>]
```
忽略差异生成中子模块的更改。<when>可以是“none”，“untracked”，“dirty”或“all”，这是默认值。使用“none”时，如果子模块包含未跟踪或修改的文件，或者其HEAD与超级项目中记录的提交不同，则可以使用“none”来修改子模块，并可用于覆盖[git-config [1]](https://git-scm.com/docs/git-config) 或 [gitmodules [5]](https://git-scm.com/docs/gitmodules)中 _ignore_ 选项的任何设置。当使用“untracked”时，如果子模块仅包含未跟踪的内容（但仍会扫描修改的内容），则子模块不会被视为dirty。使用“dirty”忽略对子模块工作树的所有更改，仅显示存储在超级项目中的提交的更改（这是1.7.0之前的行为）。使用“all”隐藏子模块的所有更改。
```
--src-prefix=<prefix>
```
显示给定的源前缀而不是“a/”。
```
--dst-prefix=<prefix>
```
显示给定的目标前缀而不是“b/”。
```
--no-prefix
```
不显示任何源或目标前缀。
```
--line-prefix=<prefix>
```
为每行输出预先附加前缀。
```
--ita-invisible-in-index
```
默认情况下，“git add -N”添加的条目在“git diff”中显示为现有空文件，在“git diff --cached”中显示为新文件。此选项使条目在“git diff”中显示为新文件，在“git diff --cached”中不存在。可以使用`--ita-visible-in-index`恢复此选项。这两个选项都是实验性的，将来可以删除。
有关这些常用选项的更详细说明，另请参阅 [gitdiffcore [7]](https://git-scm.com/docs/gitdiffcore) 。
```
-1 --base
```
```
-2 --ours
```
```
-3 --theirs
```
将工作树与“基础”版本（阶段＃1），“我们的分支”（阶段＃2）或“他们的分支”（阶段＃3）进行比较。索引仅包含针对未合并条目的这些阶段，即在解决冲突时。有关详细信息，请参阅 [git-read-tree [1]](https://git-scm.com/docs/git-read-tree) 部分“3-Way Merge”。
```
-0
```
省略未合并条目的差异输出，只显示“未合并”。仅在将工作树与索引进行比较时才能使用。
```
<path>…
```
<路径>参数，当给定时，用于将diff限制为命名路径（您可以为其下的所有文件提供目录名称和获取差异）。
## 原始输出格式
来自“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. sha1为“src”; 如果创建或未合并，则显示0{40}。
7. 空格。
8. sha1为“dst”; 如果创建，未合并或“查看工作树”，则显示0{40}。
9. 空格。
10. 状态，后跟可选的“数字”编号。
11. 使用`-z`选项时的选项卡或NUL。
12. “src”的路径
13. 使用`-z`选项时的选项卡或NUL;仅适用于C或R.
14. “dst”的路径;仅适用于C或R.
15. 使用`-z`选项时，LF或NUL终止记录。
可能的状态字母是：
* A：添加文件
* C：将文件复制到新文件中
* D：删除文件
* M：修改文件的内容或模式
* R：重命名文件
* T：更改文件类型
* U：文件已取消合并（您必须先完成合并才能提交）
* X：“未知”更改类型（最有可能是错误，请报告）
状态字母C和R后面总是跟一个分数（表示移动或复制的源和目标之间的相似性百分比）。状态字母M之后可以是文件重写的分数（表示不相似的百分比）。
<SHA1>如果文件系统上的文件是新文件并且它与索引不同步，则显示为全0。
例：
```
:100644 100644 5be4a4a 0000000 M file.c
```
如果没有`-z`选项，则会引用具有“异常”字符的路径名，如配置变量`core.quotePath`所述（参见 [git-config [1]](https://git-scm.com/docs/git-config) ）。使用`-z`，文件名逐字输出，行以NUL字节终止。
## 用于合并的diff格式
“git-diff-tree”，“git-diff-files”和“git-diff --raw”可以使用`-c`或`--cc`选项为合并提交生成diff输出。输出与上述格式的不同之处如下：
1. 每个父母都有一个冒号
2. 还有更多“src”模式和“src”sha1
3. status是每个父级的连接状态字符
4. 没有可选的“分数”数字
5. 单路径，仅适用于“dst”
例：
```
::100644 100644 100644 fabadb8 cc95eb0 4866510 MM describe.c
```
请注意，_组合diff_ 仅列出从所有父项修改的文件。
## 使用-p生成补丁
当“git-diff-index”，“git-diff-tree”或“git-diff-files”使用`-p`选项运行时，“git diff”不带`--raw`选项或“git log”使用“-p”选项，它们不会产生上述输出;相反，他们生成一个补丁文件。您可以通过`GIT_EXTERNAL_DIFF`和`GIT_DIFF_OPTS`环境变量自定义此类修补程序的创建。
-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>
```
文件模式打印为6位八进制数，包括文件类型和文件权限位。
扩展标头中的路径名不包括`a/`和`b/`前缀。
相似性指数是未更改行的百分比，相异性指数是更改行的百分比。它是一个向下舍入的整数，后跟一个百分号。因此，100％的相似性索引值保留用于两个相等的文件，而100％的相异性意味着旧文件中的任何行都不会成为新文件。
索引行包括更改前后的SHA-1校验和。<mode>如果文件模式没有改变，则包括在内;否则，单独的行表示旧模式和新模式。
3. 具有“异常”字符的路径名被引用，如配置变量`core.quotePath`所述（参见 [git-config [1]](https://git-scm.com/docs/git-config) ）。
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
```
## 组合差异格式
在显示合并时，任何差异生成命令都可以使用`-c`或`--cc`选项生成 _组合差异_。当显示与 [git-diff [1]](https://git-scm.com/docs/git-diff) 或 [git-show [1]](https://git-scm.com/docs/git-show) 的合并时，这是默认格式。另请注意，您可以为这些命令中的任何一个提供`-m`选项，以强制使用合并的各个父项生成差异。
_组合diff_ 格式如下所示：
```
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>`行才会出现。与其他人不同。具有关于检测到的内容移动（重命名和复制检测）的信息的扩展标题被设计为与两个<tree-ish>的差异一起工作。并且不会被组合diff格式使用。
3. 接下来是两行的文件/文件头
```
--- a/file
+++ b/file
```
与传统 _统一_ diff格式的双行标题类似，`/dev/null`用于表示创建或删除的文件。
4. 修改了块头格式以防止人们意外地将其馈送到`patch -p1`。创建组合差异格式用于审查合并提交更改，并不适用于应用。此更改类似于扩展 _索引_ 标头中的更改：
```
@@@ <from-file-range> <from-file-range> <to-file-range> @@@
```
组合diff格式的块头中有（父项数+ 1）`@`个字符。
与传统的 _统一_ 差异格式不同，后者显示两个文件A和B，其中一列具有`-`（减去 - 出现在A中但在B中删除），`+`（加 - 缺少A但是添加到B）或`" "`（空格 - 未更改）前缀，此格式将两个或多个文件file1，file2，...与一个文件X进行比较，并显示X与每个文件N的不同之处。每个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`输出通过组合路径名的公共前缀和后缀来紧凑地格式化路径名。例如，修改4行时将`arch/i386/Makefile`移动到`arch/x86/Makefile`的更改将显示如下：
```
arch/{i386 => x86}/Makefile | 4 +--
```
`--numstat`选项提供diffstat（1）信息，但设计用于更容易的机器消耗。 `--numstat`输出中的条目如下所示：
```
1 2 README
3 1 arch/{i386 => x86}/Makefile
```
也就是说，从左到右：
1. 添加的行数;
2. tab;
3. 删除的行数;
4. tab;
5. pathname（可能带有重命名/复制信息）;
6. 换行符。
当`-z`输出选项生效时，输出格式为：
```
1 2 README NUL
3 1 NUL arch/i386/Makefile NUL arch/x86/Makefile NUL
```
那是：
1. 添加的行数;
2. tab;
3. 删除的行数;
4. tab;
5. NUL（仅在重命名/复制时存在）;
6. 原像中的路径名;
7. NUL（仅在重命名/复制时存在）;
8. 新像中的路径名（仅在重命名/复制时存在）;
9. 一个NUL。
在重命名的情况下，原像路径之前的额外`NUL`是允许读取输出的脚本判断正在读取的当前记录是单路径记录还是重命名/复制记录而无需提前读取。读取添加和删除的行后，读取`NUL`将产生路径名，但如果是`NUL`，则记录将显示两个路径。
## 例子
```
Various ways to check your working tree
```
```
$ git diff (1)
$ git diff --cached (2)
$ git diff HEAD (3)
```
1. 尚未为下次提交暂存的工作树中的更改。
2. 索引与上次提交之间的变化;如果没有“-a”选项运行“git commit”，你会提交什么。
3. 自上次提交以来工作树中的更改;如果你运行“git commit -a”，你会提交什么
```
Comparing with arbitrary commits
```
```
$ git diff test (1)
$ git diff HEAD -- ./test (2)
$ git diff HEAD^ HEAD (3)
```
1. 不是使用当前分支的尖端，而与“测试”分支的尖端进行比较。
2. 不是与“test”分支的尖端进行比较，而与当前分支的尖端进行比较，但将比较限制为文件“test”。
3. 比较上次提交和最后一次提交之前的版本。
```
Comparing branches
```
```
$ git diff topic master (1)
$ git diff topic..master (2)
$ git diff topic...master (3)
```
1. topic与主分支之间的更改。
2. 与上述相同。
3. 自topic分支启动以来主分支上发生的更改。
```
Limiting the diff output
```
```
$ git diff --diff-filter=MRC (1)
$ git diff --name-status (2)
$ git diff arch/i386 include/asm-i386 (3)
```
1. 仅显示修改，重命名和复制，但不添加或删除。
2. 仅显示名称和更改的性质，但不显示实际的差异输出。
3. 将diff输出限制为命名子树。
```
Munging the diff output
```
```
$ git diff --find-copies-harder -B -C (1)
$ git diff -R (2)
```
1. 花费额外的周期来查找重命名，复制和完成重写（非常昂贵）。
2. 反向输出差异。
## 也可以看看
diff（1）， [git-difftool [1]](https://git-scm.com/docs/git-difftool) ， [git-log [1]](https://git-scm.com/docs/git-log) ， [gitdiffcore [7]](https://git-scm.com/docs/gitdiffcore) ， [git-format-patch [1]](https://git-scm.com/docs/git-format-patch) ， [git-apply [1]](https://git-scm.com/docs/git-apply)
## GIT
部分 [git [1]](https://git-scm.com/docs/git) 套件
- git
- git-config
- git-help
- git-init
- git-clone
- git-add
- git-status
- git-diff
- git-commit
- git-reset
- git-rm
- git-mv
- git-branch
- git-checkout
- git-merge
- git-mergetool
- git-log
- git-stash
- git-tag
- git-worktree
- git-fetch
- git-pull
- git-push
- git-remote
- git-submodule
- git-show
- git-log
- git-shortlog
- git-describe
- git-apply
- git-cherry-pick
- git-rebase
- git-revert
- git-bisect
- git-blame
- git-grep
- gitattributes
- giteveryday
- gitglossary
- githooks
- gitignore
- gitmodules
- gitrevisions
- gittutorial
- gitworkflows
- git-am
- git-format-patch
- git-send-email
- git-request-pull
- git-svn
- git-fast-import
- git-clean
- git-gc
- git-fsck
- git-reflog
- git-filter-branch
- git-instaweb
- git-archive
- git-bundle
- git-daemon
- git-update-server-info
- git-cat-file
- git-check-ignore
- git-checkout-index
- git-commit-tree
- git-count-objects
- git-diff-index
- git-for-each-ref
- git-hash-object
- git-ls-files
- git-merge-base
- git-read-tree
- git-rev-list
- git-rev-parse
- git-show-ref
- git-symbolic-ref
- git-update-index
- git-update-ref
- git-verify-pack
- git-write-tree