Git
英语 ▾ 主题 ▾ 最新版本 ▾ git-diff-tree 最后更新于 2.46.1

名称

git-diff-tree - 比较通过两个树对象找到的 blob 的内容和模式

概要

git diff-tree [--stdin] [-m] [-s] [-v] [--no-commit-id] [--pretty]
	      [-t] [-r] [-c | --cc] [--combined-all-paths] [--root] [--merge-base]
	      [<common-diff-options>] <tree-ish> [<tree-ish>] [<path>…​]

描述

比较通过两个树对象找到的 blob 的内容和模式。

如果只给出一个 <tree-ish>，则将提交与它的父级进行比较（参见下面的 --stdin）。

请注意，git diff-tree 可以使用封装在提交对象中的树。

选项

-p
-u
--patch

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

-s
--no-patch

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

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

生成包含 <n> 行上下文而不是通常的 3 行的 diff。意味着 --patch。

--output=<file>

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

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

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

--raw

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

--patch-with-raw

-p --raw 的同义词。

--indent-heuristic

启用将 diff 块边界移位的启发式方法，使补丁更容易阅读。这是默认设置。

--no-indent-heuristic

禁用缩进启发式方法。

--minimal

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

--patience

使用“耐心 diff”算法生成 diff。

--histogram

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

--anchored=<text>

使用“锚定 diff”算法生成 diff。

此选项可以多次指定。

如果源和目标中存在一行，并且仅存在一次，并且以该文本开头，则此算法尝试防止它在输出中显示为删除或添加。它在内部使用“耐心 diff”算法。

--diff-algorithm={patience|minimal|histogram|myers}

选择一个 diff 算法。变体如下

default、myers

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

minimal

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

patience

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

histogram

此算法扩展了耐心算法，以“支持低出现率的公共元素”。

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

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

生成 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> 行，后跟 ...（如果有更多行）。

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

--compact-summary

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

--numstat

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

--shortstat

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

-X[<param1,param2,…​>]
--dirstat[=<param1,param2,…​>]

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

changes

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

lines

通过执行基于行的常规 diff 分析并对删除/添加的行计数进行求和来计算 dirstat 数字。（对于二进制文件，请改为统计 64 字节块，因为二进制文件没有自然的行概念）。这种 --dirstat 行为比 changes 行为更昂贵，但它会将文件内的重新排列行与其他更改一样计入。生成的输出与从其他 --*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]）。

--name-only

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

--name-status

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

--submodule[=<format>]

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

--color[=<when>]

显示彩色 diff。--color（即没有=<when>）与 --color=always 相同。<when> 可以是 always、never 或 auto 之一。

--no-color

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

--color-moved[=<mode>]

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

no

移动的行不会突出显示。

default

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

plain

在某处添加并在另一处删除的任何行都将用 color.diff.newMoved 颜色显示。类似地，color.diff.oldMoved 将用于在 diff 中其他位置添加的已删除行。此模式将拾取所有移动的行，但在审查中它对于确定代码块是否在不进行置换的情况下移动并不太有用。

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=<modes>

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

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>]

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

color

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

plain

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

porcelain

使用一种特殊的基于行的格式，用于脚本使用。添加/删除/未更改的运行以通常的统一 diff 格式打印，从行的开头一个 +/-/` ` 字符开始，并延伸到行的末尾。输入中的换行符用一行中的波浪号 ~ 表示。

none

再次禁用单词 diff。

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

--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>

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

--full-index

在生成补丁格式输出时，不在 "index" 行中显示前几个字符，而是显示完整的预先和事后映像 Blob 对象名称。

--binary

除了 --full-index 之外，还会输出一个二进制 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 之间的 diff。生成的补丁不适合使用 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>

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

当您正在查找确切的代码块（例如结构体）并想要知道该块从创建开始的历史记录时，它非常有用：迭代地使用此功能将预映像中的有趣块反馈给 -S，并继续下去，直到您获得该块的第一个版本。

也会搜索二进制文件。

-G<regex>

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

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

+    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=<lines>

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

-W
--function-context

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

--exit-code

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

--quiet

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

--ext-diff

允许执行外部 diff 助手。如果使用 gitattributes[5] 设置外部 diff 驱动程序，则需要在 git-log[1] 及其关联命令中使用此选项。

--no-ext-diff

禁止外部 diff 驱动程序。

--textconv
--no-textconv

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

--ignore-submodules[=<when>]

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

--src-prefix=<prefix>

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

--dst-prefix=<prefix>

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

--no-prefix

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

--default-prefix

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

--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]。

<tree-ish>

树对象的 ID。

<path>…​

如果提供，结果将限制为与提供的路径规范之一匹配的文件子集。

-r

递归进入子树。

-t

显示树条目本身以及子树。意味着 -r。

--root

当指定 --root 时，初始提交将显示为一个大型创建事件。这等效于与 NULL 树的 diff。

--merge-base

不要直接比较 <tree-ish>，而是使用两个 <tree-ish> 之间的合并基础作为 "before" 侧。必须给出两个 <tree-ish>，它们都必须是提交。

--stdin

当指定 --stdin 时，命令不会从命令行获取 <tree-ish> 参数。相反，它会从其标准输入中读取包含两个 <tree>、一个 <commit> 或 <commit> 列表的行。（使用一个空格作为分隔符。）

当给出两个树时，它会比较第一个树与第二个树。当给出单个提交时，它会比较提交与其父提交。当给出剩余的提交时，它们将被视为第一个提交的父提交。

当比较两个树时，在差异之前会打印两个树的 ID（以空格分隔并以换行符结尾）。当比较提交时，会打印第一个（或唯一）提交的 ID，后跟换行符。

以下标志在比较提交（但不是树）时会进一步影响行为。

-m

默认情况下，git diff-tree --stdin 不会显示合并提交的差异。使用此标志，它会显示从其所有父提交到该提交的差异。另请参阅 -c。

-s

默认情况下，git diff-tree --stdin 会显示差异，无论是以机器可读形式（不带 -p）还是以补丁形式（带 -p）。此输出可以被抑制。它仅对 -v 标志有用。

-v

此标志会导致 git diff-tree --stdin 在差异之前也显示提交消息。

--pretty[=<format>]
--format=<format>

以给定格式美化打印提交日志的内容，其中 <format> 可以是以下之一：oneline、short、medium、full、fuller、reference、email、raw、format:<string> 和 tformat:<string>。当 <format> 不是以上任何一个，并且包含 %placeholder 时，它会像给出 --pretty=tformat:<format> 一样起作用。

请参阅 "PRETTY FORMATS" 部分以了解每种格式的一些其他详细信息。当省略 =<format> 部分时，它默认为 medium。

注意：您可以在存储库配置中指定默认的漂亮格式（请参阅 git-config[1]）。

--abbrev-commit

不要显示完整的 40 字节十六进制提交对象名称，而显示唯一地命名对象的 prefix。"--abbrev=<n>"（也会修改 diff 输出，如果它被显示）选项可用于指定 prefix 的最小长度。

这应该让 "--pretty=oneline" 对于使用 80 列终端的人来说更容易阅读。

--no-abbrev-commit

显示完整的 40 字节十六进制提交对象名称。这会否定 --abbrev-commit，无论它是显式还是由其他选项（如 "--oneline"）隐式。它也会覆盖 log.abbrevCommit 变量。

--oneline

这是 "--pretty=oneline --abbrev-commit" 的简写，用于组合使用。

--encoding=<encoding>

提交对象在它们的编码头中记录用于日志消息的字符编码；此选项可用于告诉命令以用户首选的编码重新编码提交日志消息。对于非管道命令，默认值为 UTF-8。请注意，如果一个对象声称以 X 编码，而我们正在输出为 X，我们将原样输出该对象；这意味着原始提交中的无效序列可能会被复制到输出中。同样，如果 iconv(3) 无法转换提交，我们将静默地原样输出原始对象。

--expand-tabs=<n>
--expand-tabs
--no-expand-tabs

在日志消息中执行制表符展开（用足够的空格替换每个制表符以填充到下一个显示列，该列是 <n> 的倍数），然后将其显示在输出中。--expand-tabs 是 --expand-tabs=8 的简写，--no-expand-tabs 是 --expand-tabs=0 的简写，它禁用制表符展开。

默认情况下，制表符会在以 4 个空格缩进日志消息（即 medium，这是默认值，full 和 fuller）的漂亮格式中展开。

--notes[=<ref>]

在显示提交日志消息时，显示注释提交的注释（请参阅 git-notes[1]）。当命令行上没有给出 --pretty、--format 或 --oneline 选项时，这是 git log、git show 和 git whatchanged 命令的默认行为。

默认情况下，显示的注释来自 core.notesRef 和 notes.displayRef 变量（或相应的环境覆盖）中列出的注释引用。有关更多详细信息，请参阅 git-config[1]。

使用可选的 <ref> 参数，使用该引用查找要显示的注释。当引用以 refs/notes/ 开头时，引用可以指定完整的引用名；当引用以 notes/ 开头时，refs/ 和其他情况 refs/notes/ 将被前缀以形成引用的完整名称。

多个 --notes 选项可以组合起来以控制显示哪些注释。例如："--notes=foo" 将仅显示来自 "refs/notes/foo" 的注释；"--notes=foo --notes" 将显示来自 "refs/notes/foo" 和默认注释引用的注释。

--no-notes

不显示注释。这通过重置显示注释的注释引用的列表来否定上面的 --notes 选项。选项按命令行上给出的顺序解析，因此例如 "--notes --notes=foo --no-notes --notes=bar" 将仅显示来自 "refs/notes/bar" 的注释。

--show-notes-by-default

除非给出用于显示特定注释的选项，否则显示默认注释。

--show-notes[=<ref>]
--[no-]standard-notes

这些选项已弃用。请改用上面的 --notes/--no-notes 选项。

--show-signature

通过将签名传递给 gpg --verify 来检查签名提交对象的有效性，并显示输出。

--no-commit-id

git diff-tree 在适用时输出包含提交 ID 的一行。此标志会抑制提交 ID 输出。

-c

此标志更改合并提交的显示方式（这意味着它仅在命令被给予一个 <tree-ish> 或 --stdin 时有用）。它同时显示了从每个父级到合并结果的差异，而不是一次显示一个父级和结果之间的成对差异（这是 -m 选项所做的）。此外，它只列出从所有父级修改的文件。

--cc

此标志以类似于 -c 选项的方式更改合并提交补丁的显示方式。它暗示 -c 和 -p 选项，并通过省略在父级中内容只有两种变体并且合并结果在没有修改的情况下选择了其中一种的无关紧要的块来进一步压缩补丁输出。当所有块都无关紧要时，不会显示提交本身和提交日志消息，就像在任何其他“空差异”情况下一样。

--combined-all-paths

此标志会导致合并差异（用于合并提交）列出所有父级文件的名称。因此，它只有在指定 -c 或 --cc 时才起作用，并且可能只有在检测到文件名更改时才有用（即，当请求重命名或复制检测时）。

--always

即使差异本身为空，也显示提交本身和提交日志消息。

漂亮格式

如果提交是合并提交，并且漂亮格式不是 oneline、email 或 raw，则会在 Author: 行之前插入一个额外的行。此行以 "Merge: " 开头，并打印祖先提交的哈希值，用空格隔开。请注意，如果限制了历史记录的视图，则列出的提交不一定就是 **直接** 父级提交的列表：例如，如果您只对与特定目录或文件相关的更改感兴趣。

有几种内置格式，您还可以通过设置 pretty.<name> 配置选项来定义其他格式，该选项可以是另一个格式名称，也可以是 format: 字符串，如下所述（请参阅 git-config[1]）。以下是内置格式的详细信息

  • oneline

    <hash> <title-line>

    这旨在尽可能紧凑。

  • short

    commit <hash>
Author: <author>
    <title-line>

  • medium

    commit <hash>
Author: <author>
Date:   <author-date>
    <title-line>
    <full-commit-message>

  • full

    commit <hash>
Author: <author>
Commit: <committer>
    <title-line>
    <full-commit-message>

  • fuller

    commit <hash>
Author:     <author>
AuthorDate: <author-date>
Commit:     <committer>
CommitDate: <committer-date>
    <title-line>
    <full-commit-message>

  • reference

    <abbrev-hash> (<title-line>, <short-author-date>)

    此格式用于在提交消息中引用另一个提交，与 --pretty='format:%C(auto)%h (%s, %ad)' 相同。默认情况下，日期使用 --date=short 格式化，除非显式指定了另一个 --date 选项。与任何包含格式占位符的 format: 一样，它的输出不受其他选项（如 --decorate 和 --walk-reflogs）的影响。

  • email

    From <hash> <date>
From: <author>
Date: <author-date>
Subject: [PATCH] <title-line>
    <full-commit-message>

  • mboxrd

    与 email 相似，但提交消息中的以 "From " 开头的行（前面是零个或多个 ">"）用 ">" 引用，这样就不会将其误认为是新的提交的开始。

  • raw

    raw 格式显示与存储在提交对象中的完全相同的提交。值得注意的是，哈希值将以完整形式显示，无论是否使用 --abbrev 或 --no-abbrev，并且 parents 信息将显示真实的父级提交，不会考虑移植或历史简化。请注意，此格式会影响提交的显示方式，但不会影响差异的显示方式，例如使用 git log --raw。要获得原始差异格式中的完整对象名称，请使用 --no-abbrev。

  • format:<format-string>

    format:<format-string> 格式允许您指定要显示的信息。它有点像 printf 格式，但显着区别在于您使用 %n 而不是 \n 获取换行符。

    例如，format:"The author of %h was %an, %ar%nThe title was >>%s<<%n" 会显示类似以下内容

    The author of fe6e0ee was Junio C Hamano, 23 hours ago
The title was >>t4119: test autocomputing -p<n> for traditional diff input.<<

    占位符是

    • 扩展为单个文字字符的占位符

      %n

      换行符

      %%

      原始 %

      %x00

      %x 后面跟着两位十六进制数字将被替换为具有十六进制数字值的字节（我们将在本文档的其余部分将其称为“文字格式化代码”）。

    • 影响后续占位符格式的占位符

      %Cred

      将颜色切换为红色

      %Cgreen

      将颜色切换为绿色

      %Cblue

      将颜色切换为蓝色

      %Creset

      重置颜色

      %C(…​)

      颜色规范，如 git-config[1] 的“配置文件”部分中的“值”部分所述。默认情况下，颜色仅在启用日志输出时显示（通过 color.diff、color.ui 或 --color，并尊重前者在我们要转到终端时的 auto 设置）。%C(auto,...) 作为默认值的歷史別名被接受（例如，%C(auto,red)）。指定 %C(always,...) 将显示颜色，即使在没有其他情况下启用颜色时也是如此（但请考虑仅使用 --color=always 为整个输出启用颜色，包括此格式和 git 可能着色的任何其他内容）。auto 独自使用（即 %C(auto)）将在下一个占位符上启用自动着色，直到颜色再次切换。

      %m

      左（<）、右（>）或边界（-）标记

      %w([<w>[,<i1>[,<i2>]]])

      切换行换行，类似于 git-shortlog[1] 的 -w 选项。

      %<( <N> [,trunc|ltrunc|mtrunc])

      使下一个占位符至少占用 N 个列宽，如有必要，在右侧填充空格。如果输出超过 N 列，可以选择从左侧 (ltrunc) ..ft、中间 (mtrunc) mi..le 或末尾 (trunc) rig.. 处截断（带省略号 ..）。注意 1：截断仅在 N >= 2 时才能正常工作。注意 2：N 和 M 周围的空格是可选的。注意 3：表情符号和其他宽字符将占用两个显示列，这可能会超过列边界。注意 4：分解的字符组合标记可能在填充边界处被放置错误。

      %<|( <M> )

      使下一个占位符至少占用直到第 M 个显示列，如有必要，在右侧填充空格。对于从终端窗口的右边缘测量的列位置，使用负 M 值。

      %>( <N> ), %>|( <M> )

      类似于 %<( <N> ), %<|( <M> )，但左侧填充空格

      %>>( <N> ), %>>|( <M> )

      类似于 %>( <N> ), %>|( <M> )，但如果下一个占位符占用的空格数超过给定值，并且左侧有空格，则使用这些空格

      %><( <N> ), %><|( <M> )

      类似于 %<( <N> ), %<|( <M> )，但两侧都填充（即文本居中）

    • 扩展为从提交中提取的信息的占位符

      %H

      提交哈希值

      %h

      缩写提交哈希值

      %T

      树哈希值

      %t

      缩写树哈希值

      %P

      父哈希值

      %p

      缩写父哈希值

      %an

      作者姓名

      %aN

      作者姓名（尊重 .mailmap，请参阅 git-shortlog[1] 或 git-blame[1]）

      %ae

      作者电子邮件

      %aE

      作者电子邮件（遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

      %al

      作者电子邮件本地部分（@ 符号之前的部分）

      %aL

      作者本地部分（参见 %al），遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

      %ad

      作者日期（格式遵循 --date= 选项）

      %aD

      作者日期，RFC2822 样式

      %ar

      作者日期，相对

      %at

      作者日期，UNIX 时间戳

      %ai

      作者日期，ISO 8601 类格式

      %aI

      作者日期，严格 ISO 8601 格式

      %as

      作者日期，短格式（YYYY-MM-DD）

      %ah

      作者日期，人性化样式（类似 git-rev-list[1] 的 --date=human 选项）

      %cn

      提交者姓名

      %cN

      提交者姓名（遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

      %ce

      提交者电子邮件

      %cE

      提交者电子邮件（遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

      %cl

      提交者电子邮件本地部分（@ 符号之前的部分）

      %cL

      提交者本地部分（参见 %cl），遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

      %cd

      提交者日期（格式遵循 --date= 选项）

      %cD

      提交者日期，RFC2822 样式

      %cr

      提交者日期，相对

      %ct

      提交者日期，UNIX 时间戳

      %ci

      提交者日期，ISO 8601 类格式

      %cI

      提交者日期，严格 ISO 8601 格式

      %cs

      提交者日期，短格式（YYYY-MM-DD）

      %ch

      提交者日期，人性化样式（类似 git-rev-list[1] 的 --date=human 选项）

      %d

      引用名称，类似 git-log[1] 的 --decorate 选项

      %D

      引用名称，不带 " (", ")" 包裹。

      %(decorate[:<options>])

      带有自定义装饰的引用名称。decorate 字符串后面可以跟随一个冒号和零个或多个以逗号分隔的选项。选项值可能包含文字格式代码。由于其在选项语法中的作用，必须对逗号 (%x2C) 和右括号 (%x29) 使用这些代码。

      • prefix=<value>: 显示在引用名称列表之前。默认为 " ("。

      • suffix=<value>: 显示在引用名称列表之后。默认为 ")"。

      • separator=<value>: 显示在引用名称之间。默认为 ",  "。

      • pointer=<value>: 显示在 HEAD 和它指向的分支之间（如果有）。默认为 " ->  "。

      • tag=<value>: 显示在标签名称之前。默认为 "tag:  "。

    例如，要生成没有包裹或标签注释的装饰，并且使用空格作为分隔符

    + %(decorate:prefix=,suffix=,tag=,separator= )

    %(describe[:<options>])

    人类可读的名称，类似 git-describe[1]；对于无法描述的提交，为空字符串。describe 字符串后面可以跟随一个冒号和零个或多个以逗号分隔的选项。当标签在同一时间添加或删除时，描述可能会不一致。

    • tags[=<bool-value>]: 不仅考虑带注释的标签，还要考虑轻量级标签。

    • abbrev=<number>: 不使用默认的十六进制数字数量（根据存储库中对象的数量而变化，默认值为 7），而是使用 <number> 位数字，或者使用形成唯一对象名称所需的位数。

    • match=<pattern>: 仅考虑与给定 glob(7) 模式匹配的标签，不包括 "refs/tags/" 前缀。

    • exclude=<pattern>: 不要考虑与给定 glob(7) 模式匹配的标签，不包括 "refs/tags/" 前缀。

    %S

    在命令行中给出的引用名称，通过该引用名称到达提交（类似于 git log --source），仅适用于 git log

    %e

    编码

    %s

    主题

    %f

    经过清理的主题行，适合作为文件名

    %b

    主体

    %B

    原始主体（未包装的主题和主体）

    %N

    提交注释

    %GG

    来自 GPG 的已签名提交的原始验证消息

    %G?

    显示 "G" 表示有效签名，"B" 表示无效签名，"U" 表示有效签名但有效性未知，"X" 表示已过期的有效签名，"Y" 表示由已过期的密钥签名的有效签名，"R" 表示由已吊销的密钥签名的有效签名，"E" 表示签名无法检查（例如，缺少密钥），"N" 表示没有签名

    %GS

    显示已签名提交的签名者姓名

    %GK

    显示用于签署已签名提交的密钥

    %GF

    显示用于签署已签名提交的密钥的指纹

    %GP

    显示用于签署已签名提交的子密钥的主密钥的指纹

    %GT

    显示用于签署已签名提交的密钥的信任级别

    %gD

    reflog 选择器，例如，refs/stash@{1} 或 refs/stash@{2 minutes ago}；格式遵循为 -g 选项描述的规则。@ 之前的部分是命令行中给出的引用名称（因此 git log -g refs/heads/master 将产生 refs/heads/master@{0}）。

    %gd

    简化的 reflog 选择器；与 %gD 相同，但引用名称部分已简化为人类可读性（因此 refs/heads/master 变为 master）。

    %gn

    reflog 身份名称

    %gN

    reflog 身份名称（遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

    %ge

    reflog 身份电子邮件

    %gE

    reflog 身份电子邮件（遵循 .mailmap，参见 git-shortlog[1] 或 git-blame[1]）

    %gs

    reflog 主题

    %(trailers[:<options>])

    显示 git-interpret-trailers[1] 解释的主体的尾部。trailers 字符串后面可以跟随一个冒号和零个或多个以逗号分隔的选项。如果任何选项被提供多次，则最后一次出现的选项生效。

    • key=<key>: 仅显示具有指定 <key> 的尾部。匹配不区分大小写，尾部冒号是可选的。如果选项被提供多次，则显示与任何键匹配的尾部行。此选项会自动启用 only 选项，以便隐藏尾部块中的非尾部行。如果不需要这样做，可以使用 only=false 禁用它。例如，%(trailers:key=Reviewed-by) 显示具有键 Reviewed-by 的尾部行。

    • only[=<bool>: 选择是否应包含来自尾部块的非尾部行。

    • separator=<sep>: 指定插入在尾部行之间的分隔符。默认为换行符。字符串 <sep> 可能包含上面描述的文字格式代码。要使用逗号作为分隔符，必须使用 %x2C，否则它将被解析为下一个选项。例如，%(trailers:key=Ticket,separator=%x2C ) 显示所有键为 "Ticket" 的尾部行，用逗号和空格分隔。

    • unfold[=<bool>: 使其行为类似于 interpret-trailer 的 --unfold 选项。例如，%(trailers:only,unfold=true) 展开并显示所有尾部行。

    • keyonly[=<bool>: 仅显示尾部的键部分。

    • valueonly[=<bool>: 仅显示尾部的值部分。

    • key_value_separator=<sep>: 指定插入在每个尾部的键和值之间的分隔符。默认为 ": "。否则，它与上面的 separator=<sep> 具有相同的语义。

注意
 一些占位符可能取决于提供给修订遍历引擎的其他选项。例如，%g* reflog 选项将插入空字符串，除非我们正在遍历 reflog 条目（例如，通过 git log -g）。%d 和 %D 占位符将使用 "短" 装饰格式，如果命令行中尚未提供 --decorate。

布尔选项接受可选值 [=<bool-value>]。值 true、false、on、off 等都接受。参见 git-config[1] 中 "EXAMPLES" 部分的 "boolean" 子部分。如果布尔选项没有值，则启用它。

如果在占位符的 % 之后添加一个 +（加号），则如果且仅当占位符扩展为非空字符串时，将在扩展之前插入一个换行符。

如果在占位符的 % 之后添加一个 -（减号），则如果且仅当占位符扩展为空字符串时，将删除紧接扩展之前的连续换行符。

如果在占位符的 % 之后添加一个 ` `（空格），则如果且仅当占位符扩展为非空字符串时，将在扩展之前插入一个空格。

  • tformat

    tformat: 格式的工作方式与 format: 完全相同，只是它提供的是“终止符”语义，而不是“分隔符”语义。换句话说，每个提交都会追加消息终止符字符（通常是换行符），而不是在条目之间放置分隔符。这意味着单行格式的最后一个条目将使用换行符正确终止，就像“oneline”格式一样。例如

    $ git log -2 --pretty=format:%h 4da45bef \
  | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/'
4da45be
7134973 -- NO NEWLINE

$ git log -2 --pretty=tformat:%h 4da45bef \
  | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/'
4da45be
7134973

    此外，任何包含 % 的未识别字符串都被解释为在其前面有 tformat:。例如，这两个是等效的

    $ git log -2 --pretty=tformat:%h 4da45bef
$ git log -2 --pretty=%h 4da45bef

原始输出格式

"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. 状态，后面可能跟有可选的“分数”数字。

  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 后面可能跟着分数（表示差异百分比），用于文件重写。

如果文件系统上的文件与索引不同步，则 "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 选项，为合并提交生成 diff 输出。该输出与上面描述的格式不同，在以下方面有所不同

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

  2. 有更多“src”模式和“src”sha1

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

  4. 没有可选的“分数”数字

  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

请注意，合并 diff 仅列出从所有父项修改的文件。

使用 -p 生成补丁文本

使用 -p 选项运行 git-diff[1]、git-log[1]、git-show[1]、git-diff-index[1]、git-diff-tree[1] 或 git-diff-files[1] 会生成补丁文本。您可以通过 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>

    文件模式以包含文件类型和文件权限位的 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 标题”。

合并 diff 格式

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

"合并 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> 与其他 <mode> 不同时出现。用于提供有关检测到的内容移动（重命名和复制检测）信息的扩展标题旨在与两个 <tree-ish> 的 diff 一起使用，而不被合并 diff 格式使用。

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

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

    与传统 统一 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。合并 diff 格式是为合并提交更改的审核而创建的，并非旨在应用。更改与扩展 索引 标题中的更改类似

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

    合并 diff 格式的 Chunk 标题中包含 (父项数量 + 1) 个 @ 字符。

与传统 统一 diff 格式不同，传统 统一 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 是 stage 2，即“我们的版本”，file2 是 stage 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

也就是说，从左到右

  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. 源路径；

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

  8. 目标路径（仅在重命名/复制时存在）；

  9. 一个 NUL。

在重命名情况下，源路径之前的额外NUL 允许读取输出的脚本，在不提前读取的情况下，判断当前正在读取的记录是单路径记录还是重命名/复制记录。 在读取添加和删除行后，读取到NUL 会得到路径名，但如果它是NUL，记录将显示两个路径。

GIT

是 git[1] 套件的一部分

scroll-to-top