设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.49.1 → 2.50.1 无更改
- 2.49.0 无变更
- 2.48.1 → 2.48.2 无更改
-
2.48.0
2025-01-10
- 2.47.1 → 2.47.3 无更改
-
2.47.0
2024-10-06
- 2.46.1 → 2.46.4 无更改
-
2.46.0
2024-07-29
- 2.45.4 无更改
-
2.45.3
2024-11-26
- 2.45.1 → 2.45.2 无更改
-
2.45.0
2024-04-29
- 2.44.1 → 2.44.4 无更改
-
2.44.0
2024-02-23
- 2.43.2 → 2.43.7 无变更
-
2.43.1
2024-02-09
-
2.43.0
2023-11-20
- 2.42.2 → 2.42.4 无更改
-
2.42.1
2023-11-02
-
2.42.0
2023-08-21
- 2.41.1 → 2.41.3 无更改
-
2.41.0
2023-06-01
- 2.40.1 → 2.40.4 无更改
-
2.40.0
2023-03-12
- 2.39.1 → 2.39.5 无变化
-
2.39.0
2022-12-12
- 2.38.1 → 2.38.5 无更改
-
2.38.0
2022-10-02
- 2.37.3 → 2.37.7 无更改
-
2.37.2
2022-08-11
- 2.36.1 → 2.37.1 无变化
-
2.36.0
2022-04-18
- 2.34.1 → 2.35.8 无更改
-
2.34.0
2021-11-15
- 2.33.1 → 2.33.8 无更改
-
2.33.0
2021-08-16
- 2.32.1 → 2.32.7 无变更
-
2.32.0
2021-06-06
- 2.31.1 → 2.31.8 无更改
-
2.31.0
2021-03-15
- 2.30.1 → 2.30.9 无更改
-
2.30.0
2020-12-27
- 2.29.1 → 2.29.3 无更改
-
2.29.0
2020-10-19
- 2.28.1 无更改
-
2.28.0
2020-07-27
- 2.25.2 → 2.27.1 无变化
-
2.25.1
2020-02-17
-
2.25.0
2020-01-13
- 2.24.1 → 2.24.4 无更改
-
2.24.0
2019-11-04
- 2.22.1 → 2.23.4 无更改
-
2.22.0
2019-06-07
- 2.21.1 → 2.21.4 无更改
-
2.21.0
2019-02-24
- 2.20.1 → 2.20.5 无更改
-
2.20.0
2018-12-09
- 2.19.3 → 2.19.6 无更改
-
2.19.2
2018-11-21
- 2.19.1 无更改
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 无更改
-
2.18.0
2018-06-21
- 2.17.1 → 2.17.6 无更改
-
2.17.0
2018-04-02
-
2.16.6
2019-12-06
-
2.15.4
2019-12-06
-
2.14.6
2019-12-06
-
2.13.7
2018-05-22
-
2.12.5
2017-09-22
-
2.11.4
2017-09-22
- 2.10.5 无更改
-
2.9.5
2017-07-30
-
2.8.6
2017-07-30
- 2.7.6 无更改
-
2.6.7
2017-05-05
-
2.5.6
2017-05-05
-
2.4.12
2017-05-05
-
2.3.10
2015-09-28
- 2.1.4 → 2.2.3 无更改
-
2.0.5
2014-12-17
概要
git
diff
[<options>] [<commit>] [--
] [<path>…]git
diff
[<options>]--cached
[--merge-base
] [<commit>] [--
] [<path>…]git
diff
[<options>] [--merge-base
] <commit> [<commit>…] <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] 暂存这些更改。
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>,而是使用 <commit> 和HEAD
的合并基准。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>,而是使用 <commit> 和HEAD
的合并基准。git
diff
--merge-base
A
等同于git
diff
$
(git
merge-base
A
HEAD
)。 git
diff
[<options>] [--merge-base
] <commit> <commit> [--
] [<path>...]-
此形式用于查看两个任意 <commit> 之间的更改。
如果给定了
--merge-base
,则将两个提交的合并基准用作“之前”的一方。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> 的共同祖先开始。
git
diff
A...B
等同于git
diff
$
(git
merge-base
A
B
)B
。你可以省略任意一个 <commit>,其效果与使用HEAD
相同。
如果你正在进行一些特殊操作,应注意上述描述中除 --merge-base
情况和使用 ..
符号的最后两种形式外,所有 <commit> 都可以是任意 <tree>。一个重要的树是由名为 AUTO_MERGE
的引用指向的树,它由 ort
合并策略在遇到合并冲突时写入(参见 git-merge[1])。将工作树与 AUTO_MERGE
进行比较会显示你到目前为止为解决文本冲突所做的更改(参见下面的示例)。
有关拼写 <commit> 的更完整列表,请参阅 gitrevisions[7] 中的“SPECIFYING REVISIONS”部分。然而,diff
是关于比较两个端点,而不是范围,并且范围符号(<commit>..
<commit> 和 <commit>...
<commit>)不表示 gitrevisions[7] 中“SPECIFYING RANGES”部分定义的范围。
选项
-p
-u
--patch
-
生成补丁(参见 使用 -p 生成补丁文本)。这是默认值。
-s
--no-patch
-
禁止来自 diff 机制的所有输出。对于像
git
show
这样默认显示补丁的命令,这很有用,可以抑制其输出,或者取消别名中命令行上早期--patch
、--stat
等选项的效果。 -U
<n>--unified=
<n>-
生成包含 <n> 行上下文(而不是通常的三行)的 diff。隐含
--patch
。 --output=
<file>-
输出到特定文件而不是标准输出。
--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
-
使用“patience diff”算法生成差异。
--histogram
-
使用“histogram diff”算法生成差异。
--anchored=
<text>-
使用“anchored diff”算法生成差异。
此选项可以多次指定。
如果一行在源和目标中都存在,只存在一次,并且以 <text> 开头,则此算法会尝试阻止其在输出中显示为删除或添加。它内部使用“patience diff”算法。
--diff-algorithm=
(patience
|minimal
|histogram
|myers
)-
选择一种差异算法。变体如下:
例如,如果您将
diff.algorithm
变量配置为非默认值,但希望使用默认值,则必须使用--diff-algorithm=default
选项。 --stat
[=
<width>[,
<name-width>[,
<count>]]]-
生成差异统计。默认情况下,文件名部分将占用必要的最大空间,其余部分用于图表部分。最大宽度默认为终端宽度,如果未连接到终端则为 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-color-moved-ws
-
执行移动检测时不忽略空白。这可以用于覆盖配置设置。它与
--color-moved-ws=no
相同。 --word-diff
[=
<mode>]-
默认情况下,单词由空白分隔;参见下面的
--word-diff-regex
。<mode> 默认为plain
,并且必须是以下之一:请注意,尽管第一个模式的名称如此,如果启用,所有模式都使用颜色高亮显示更改的部分。
--word-diff-regex=
<regex>-
使用 <regex> 来决定什么是单词,而不是将非空白字符的连续序列视为一个单词。除非已启用,否则这也隐含
--word-diff
。<regex> 的每个不重叠匹配都被视为一个单词。这些匹配之间的任何内容都被视为空白并被忽略(!)以用于查找差异的目的。你可能需要将 |[
^
[:space:
]] 附加到你的正则表达式,以确保它匹配所有非空白字符。包含换行符的匹配在换行符处会被静默截断(!)。例如,
--word-diff-regex=.
会将每个字符视为一个单词,并相应地逐字符显示差异。正则表达式也可以通过 diff 驱动程序或配置选项设置,参见 gitattributes[5] 或 git-config[1]。显式给定它会覆盖任何 diff 驱动程序或配置设置。Diff 驱动程序会覆盖配置设置。
--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”行上显示前几个字符,而是显示完整的原图像和后图像 blob 对象名称。
--binary
-
除了
--full-index
之外,还输出一个二进制 diff,该 diff 可以用git-apply
应用。隐含--patch
。 --abbrev
[=
<n>]-
在 diff-raw 格式输出和 diff-tree 头行中,不显示完整的 40 字节十六进制对象名称,而是显示最短的、至少 <n> 个十六进制数字长且唯一引用该对象的前缀。在 diff-patch 输出格式中,
--full-index
具有更高的优先级,即如果指定了--full-index
,则无论--abbrev
如何,都将显示完整的 blob 名称。非默认位数的数字可以使用--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
或git
apply
;这仅适用于那些只想专注于审查更改后文本的人。此外,输出显然缺乏足够的信息以反向应用此类补丁,即使是手动操作也一样,因此得名此选项。与
-B
一起使用时,也会省略删除/创建对的删除部分中的原始图像。 -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
会排除已添加和已删除的路径。请注意,并非所有 diff 都能包含所有类型。例如,如果禁用对这些类型的检测,则不会出现已复制和已重命名条目。
-S
<string>-
查找更改文件中指定 <string> 出现次数(即添加/删除)的差异。供脚本编写者使用。
当您正在寻找一段精确的代码块(例如一个结构体),并想知道该代码块自首次出现以来的历史记录时,这很有用:迭代使用此功能,将原始图像中有趣的代码块重新输入到
-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=
<object-id>-
查找更改指定对象出现次数的差异。类似于
-S
,只是参数不同,它不搜索特定字符串,而是搜索特定对象 ID。该对象可以是 blob 或子模块提交。它隐含了
git-log
中的-t
选项,以也查找树。 --pickaxe-all
-
当
-S
或-G
找到更改时,显示该变更集中所有更改,而不仅仅是包含 <string> 更改的文件。 --pickaxe-regex
-
将提供给
-S
的 <string> 视为扩展的 POSIX 正则表达式进行匹配。 -O
<orderfile>-
控制文件在输出中出现的顺序。这会覆盖
diff.orderFile
配置变量(参见 git-config[1])。要取消diff.orderFile
,请使用-O/dev/null
。输出顺序由 <orderfile> 中 glob 模式的顺序决定。路径名匹配第一个模式的所有文件首先输出,路径名匹配第二个模式(但不匹配第一个)的所有文件接下来输出,依此类推。路径名不匹配任何模式的所有文件最后输出,就像文件末尾有一个隐式匹配所有模式一样。如果多个路径名具有相同的优先级(它们匹配相同的模式但没有更早的模式),则它们相对于彼此的输出顺序是正常顺序。
<orderfile> 解析如下:
-
空行被忽略,因此它们可以用作分隔符以提高可读性。
-
以井号("
#
")开头的行被忽略,因此它们可以用作注释。如果模式以井号开头,请在模式开头添加反斜杠("\")。 -
其他每行包含一个模式。
模式具有与
fnmatch
(3) 使用的模式相同的语法和语义,但没有FNM_PATHNAME
标志,例外是如果移除任意数量的最终路径名组件匹配模式,则路径名也匹配模式。例如,模式“foo*bar
”匹配“fooasdfbar
”和“foo/bar/baz/asdf
”但不匹配“foobarx
”。 -
--skip-to=
<file>--rotate-to=
<file>-
从输出中丢弃命名 <file> 之前的文件(即跳到),或将其移到输出的末尾(即旋转到)。这些选项主要用于
git
difftool
命令,否则可能不太有用。 -R
-
交换两个输入;即,显示从索引或磁盘文件到树内容的差异。
--relative
[=
<path>]--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] 中“Defining a custom hunk-header”)。 --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] 或 diff 底层命令启用。
--ignore-submodules
[=
(none
|untracked
|dirty
|all
)]-
在生成差异时忽略对子模块的更改。
all
是默认值。使用none
将在子模块包含未跟踪或已修改文件,或其HEAD
与超项目中记录的提交不同时,将其视为已修改,并可用于覆盖 git-config[1] 或 gitmodules[5] 中ignore
选项的任何设置。当使用untracked
时,如果子模块仅包含未跟踪内容,则不会将其视为脏(但仍会扫描其已修改内容)。使用dirty
会忽略对子模块工作树的所有更改,仅显示超项目中存储的提交更改(这是直到 1.7.0 的行为)。使用all
会隐藏对子模块的所有更改。 --src-prefix=
<prefix>-
显示给定的源前缀 <prefix> 而不是 "a/"。
--dst-prefix=
<prefix>-
显示给定的目标前缀 <prefix> 而不是 "b/"。
--no-prefix
-
不显示任何源或目标前缀。
--default-prefix
-
使用默认的源和目标前缀(“a/”和“b/”)。这会覆盖配置变量,例如
diff.noprefix
、diff.srcPrefix
、diff.dstPrefix
和diff.mnemonicPrefix
(参见 git-config[1])。 --line-prefix=
<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]。
-1
--base
-2
--ours
-3
--theirs
-
将工作区与
-
使用
-1
或--base
时的“基础”版本(阶段 #1), -
使用
-2
或--ours
时的“我们的分支”(阶段 #2),或 -
使用
-3
或--theirs
时的“他们的分支”(阶段 #3)。
索引仅包含未合并条目的这些阶段,即在解决冲突时。有关详细信息,请参见 git-read-tree[1] 的“3-Way Merge”部分。
-
-0
-
省略未合并条目的差异输出,仅显示“Unmerged”。仅在比较工作树与索引时可使用。
- <path>...
-
如果给定 <path> 参数,它们将用于将差异限制为指定的路径(可以给定目录名称并获取其下所有文件的差异)。
原始输出格式
来自 git-diff-index
、git-diff-tree
、git-diff-files
和 git
diff
--raw
的原始输出格式非常相似。
这些命令都比较两组事物;比较的内容有所不同:
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
即从左到右:
-
一个冒号。
-
"src" 的模式;如果为创建或未合并,则为 000000。
-
一个空格。
-
"dst" 的模式;如果为删除或未合并,则为 000000。
-
一个空格。
-
"src" 的 SHA1;如果为创建或未合并,则为 0{40}。
-
一个空格。
-
"dst" 的 SHA1;如果为删除、未合并或“工作区与索引不同步”,则为 0{40}。
-
一个空格。
-
状态,后跟可选的“分数”数字。
-
当使用
-z
选项时,一个制表符或一个 NUL。 -
"src" 的路径。
-
当使用
-z
选项时,一个制表符或一个 NUL;仅在 C 或 R 状态下存在。 -
"dst" 的路径;仅在 C 或 R 状态下存在。
-
当使用
-z
选项时,一个 LF 或一个 NUL,用于终止记录。
可能的状态字母是:
-
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 字节终止。
合并的 diff 格式
git-diff-tree
、git-diff-files
和 git-diff
--raw
可以使用 -c
或 --cc
选项来生成合并提交的差异输出。输出格式与上述描述的格式不同,如下所示:
-
每个父级都有一个冒号
-
有更多的“src”模式和“src”SHA1
-
状态是每个父级的状态字符的连接
-
没有可选的“分数”数字
-
以制表符分隔的文件路径名
对于 -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
请注意,combined diff 仅列出从所有父级修改过的文件。
使用 -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 格式略有不同:
-
它前面是“git diff”头,看起来像这样:
diff --git a/file1 b/file2
除非涉及重命名/复制,否则
a/
和b/
文件名相同。特别是,即使是创建或删除,也不会使用/dev/null
来代替a/
或b/
文件名。当涉及重命名/复制时,
file1
和file2
分别显示重命名/复制的源文件名称和重命名/复制生成的文件名称。 -
后面跟着一个或多个扩展头行:
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>;否则,单独的行指示旧模式和新模式。
-
包含“不寻常”字符的路径名将按照配置变量
core.quotePath
的解释进行引用(参见 git-config[1])。 -
输出中所有
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
-
Hunk 头会提及 hunk 应用到的函数名称。有关如何根据特定语言进行调整的详细信息,请参见 gitattributes[5] 中的“定义自定义 hunk-header”。
组合 diff 格式
任何生成差异的命令都可以采用 -c
或 --cc
选项,在显示合并时生成合并差异。这是用 git-diff[1] 或 git-show[1] 显示合并时的默认格式。另请注意,您可以向这些命令中的任何一个提供合适的 --diff-merges
选项,以强制生成特定格式的差异。
“组合 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);
-
它前面是“git diff”头,看起来像这样(使用
-c
选项时):diff --combined file
或者像这样(使用
--cc
选项时):diff --cc file
-
后面跟着一个或多个扩展头行(此示例显示了一个包含两个父级的合并):
index
<hash>,
<hash>..
<hash>mode
<mode>,
<mode>..
<mode>new
file
mode
<mode>deleted
file
mode
<mode>,
<mode>mode
<mode>,
<mode>..
<mode> 行仅在至少一个 <mode> 与其余不同时出现。带有检测到的内容移动(重命名和复制检测)信息的扩展头旨在与两个 <tree-ish> 的差异配合使用,并且不用于组合差异格式。 -
后面跟着一个两行的“源文件/目标文件”头:
--- a/file +++ b/file
类似于传统 unified diff 格式的两行头,
/dev/null
用于指示已创建或已删除的文件。然而,如果提供了 --combined-all-paths 选项,您将得到一个 N+1 行的“源文件/目标文件”头,而不是两行的“源文件/目标文件”头,其中 N 是合并提交中父级的数量:
--- a/file --- a/file --- a/file +++ b/file
如果重命名或复制检测处于活动状态,这种扩展格式会很有用,可以让您查看不同父级中文件的原始名称。
-
块头格式已被修改,以防止人们意外地将其馈送给
patch
-p1
。组合差异格式是为审查合并提交更改而创建的,并非旨在应用。更改类似于扩展 索引 头中的更改:@@@ <from-file-range> <from-file-range> <to-file-range> @@@
组合 diff 格式的块头中有(父级数量 + 1)个
@
字符。
与传统的“统一”差异格式(显示两个文件 A 和 B,以及一个单列,其中包含 -
(减号——出现在 A 中但从 B 中删除)、+
(加号——A 中缺失但添加到 B 中)或 "
"
(空格——未更改)前缀)不同,此格式比较两个或更多文件 file1、file2 等与一个文件 X,并显示 X 与每个 fileN 的差异。每行输出前面都添加了一列,用于说明 X 的行与 fileN 有何不同。
N 列中的 -
字符表示该行出现在 fileN 中,但未出现在结果中。N 列中的 +
字符表示该行出现在结果中,但 fileN 中没有该行(换句话说,该行是从该父级角度添加的)。
在上述示例输出中,函数签名从两个文件都进行了更改(因此从 file1 和 file2 都删除了两个 -
,加上 ++
表示添加的一行未出现在 file1 或 file2 中)。此外,其他八行与 file1 相同,但未出现在 file2 中(因此以 +
为前缀)。
当由 git
diff-tree
-c
显示时,它会比较合并提交的父级与合并结果(即 file1..fileN 是父级)。当由 git
diff-files
-c
显示时,它会比较两个未解决的合并父级与工作树文件(即 file1 是阶段 2,也称为“我们的版本”,file2 是阶段 3,也称为“他们的版本”)。
其他 diff 格式
--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
即从左到右:
-
添加的行数;
-
一个制表符;
-
删除的行数;
-
一个制表符;
-
路径名(可能包含重命名/复制信息);
-
一个换行符。
当 -z
输出选项生效时,输出格式如下:
1 2 README NUL 3 1 NUL arch/i386/Makefile NUL arch/x86/Makefile NUL
即:
-
添加的行数;
-
一个制表符;
-
删除的行数;
-
一个制表符;
-
一个 NUL(仅在重命名/复制时存在);
-
原始映像中的路径名;
-
一个 NUL(仅在重命名/复制时存在);
-
后映像中的路径名(仅在重命名/复制时存在);
-
一个 NUL。
在重命名情况中,原始图像路径前的额外 NUL
是为了让读取输出的脚本能够判断当前读取的记录是单路径记录还是重命名/复制记录,而无需提前读取。在读取添加和删除的行之后,读取到 NUL
将得到路径名,但如果该路径名为 NUL
,则记录将显示两条路径。
示例
- 检查工作树的各种方法
-
$ git diff (1) $ git diff --cached (2) $ git diff HEAD (3) $ git diff AUTO_MERGE (4)
-
工作树中尚未暂存用于下一次提交的更改。
-
索引与你上次提交之间的更改;如果你运行
git
commit
而不带-a
选项,你将提交的内容。 -
工作树中自上次提交以来的更改;如果你运行
git
commit
-a
,你将提交的内容。 -
你到目前为止为解决文本冲突所做的工作区更改。
-
- 与任意提交进行比较
-
$ git diff test (1) $ git diff HEAD -- ./test (2) $ git diff HEAD^ HEAD (3)
-
不是使用当前分支的尖端,而是与“test”分支的尖端进行比较。
-
不是与“test”分支的尖端进行比较,而是与当前分支的尖端进行比较,但将比较限制在文件“test”。
-
比较上次提交之前和上次提交的版本。
-
- 比较分支
-
$ git diff topic master (1) $ git diff topic..master (2) $ git diff topic...master (3)
-
主题分支和 master 分支的最新提交之间的更改。
-
同上。
-
自主题分支从 master 分支创建以来,master 分支上发生的更改。
-
- 限制差异输出
-
$ git diff --diff-filter=MRC (1) $ git diff --name-status (2) $ git diff arch/i386 include/asm-i386 (3)
-
只显示修改、重命名和复制,不显示添加或删除。
-
只显示名称和更改性质,不显示实际差异输出。
-
将差异输出限制为命名子树。
-
- 修改差异输出
-
$ git diff --find-copies-harder -B -C (1) $ git diff -R (2)
-
花费额外的周期来查找重命名、复制和完全重写(非常昂贵)。
-
以相反顺序输出差异。
-
配置
本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同:
diff.autoRefreshIndex
-
当使用
git
diff
比较工作树文件时,不要将仅状态更改视为已更改。相反,静默运行git
update-index
--refresh
以更新工作树内容与索引内容匹配的路径的缓存状态信息。此选项默认为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
输出中文件名部分的宽度。如果设置,适用于除format-patch
之外的所有生成--stat
输出的命令。 diff.statGraphWidth
-
限制
--stat
输出中图表部分的宽度。如果设置,适用于除format-patch
之外的所有生成--stat
输出的命令。 diff.context
-
生成差异时包含 <n> 行上下文,而不是默认的 3 行。此值会被
-U
选项覆盖。 diff.interHunkContext
-
显示差异块之间的上下文,最多指定行数,从而将彼此接近的块合并。此值作为
--inter-hunk-context
命令行选项的默认值。 diff.external
-
如果设置了此配置变量,则差异生成不使用内部差异机制,而是使用给定的命令。可以使用
GIT_EXTERNAL_DIFF
环境变量覆盖。该命令将使用 git[1] 中“git Diffs”下描述的参数进行调用。注意:如果您只想在部分文件上使用外部差异程序,您可能希望改用 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
通常显示的子模块摘要,除非通过使用--ignore-submodules
命令行选项来覆盖。git
submodule
命令不受此设置影响。默认情况下,此设置为 untracked,以便忽略任何未跟踪的子模块。 diff.mnemonicPrefix
-
如果设置,
git
diff
会根据比较内容使用与标准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.
<驱动器>.command
-
自定义差异驱动命令。详情请参阅 gitattributes[5]。
diff.
<驱动器>.trustExitCode
-
如果此布尔值设置为
true
,则diff.
<驱动器>.command
命令应在认为输入文件相等时返回退出代码 0,或在认为它们不同时返回 1,类似于diff
(1)。如果设置为false
(默认值),则命令应返回退出代码 0,无论是否相等。任何其他退出代码都会导致 Git 报告致命错误。 diff.
<驱动器>.xfuncname
-
差异驱动器应使用的正则表达式以识别 hunk 标题。也可以使用内置模式。详情请参阅 gitattributes[5]。
diff.
<驱动器>.binary
-
将此选项设置为
true
可使差异驱动器将文件视为二进制。详情请参阅 gitattributes[5]。 diff.
<驱动器>.textconv
-
差异驱动器应调用以生成文件文本转换版本的命令。转换结果用于生成人类可读的差异。详情请参阅 gitattributes[5]。
diff.
<驱动器>.wordRegex
-
差异驱动器应使用的正则表达式以分割行中的单词。详情请参阅 gitattributes[5]。
diff.
<驱动器>.cachetextconv
-
将此选项设置为
true
可使差异驱动器缓存文本转换输出。详情请参阅 gitattributes[5]。 diff.indentHeuristic
-
将此选项设置为
false
以禁用默认的启发式算法,该算法会移动差异块边界以使补丁更易于阅读。 diff.algorithm
-
选择一种差异算法。变体如下:
diff.wsErrorHighlight
-
高亮显示差异的
context
(上下文)、old
(旧)或new
(新)行中的空白错误。多个值用逗号分隔,none
重置先前的值,default
将列表重置为new
,all
是old,new,context
的简写。空白错误使用color.diff.whitespace
颜色着色。命令行选项--ws-error-highlight=
<类型> 会覆盖此设置。 diff.colorMoved
-
如果设置为有效的 <模式> 或
true
值,差异中移动的行会以不同的颜色显示。有关有效模式的详细信息,请参阅--color-moved
。如果仅设置为true
,则将使用默认颜色模式。当设置为false
时,移动的行不着色。 diff.colorMovedWS
-
当使用
diff.colorMoved
设置等方式对移动的行进行着色时,此选项控制空格的处理模式。有关有效模式的详细信息,请参阅 git-diff[1] 中的--color-moved-ws
。