整数参数指定截断百分比(默认为3%)。输出中不显示贡献小于此百分比的目录。
示例:以下内容将计数已更改的文件,同时忽略占已更改文件总数少于10%的目录,并累积父目录中的子目录计数:--dirstat=files,10,cumulative。
--summary
输出扩展头信息的精简摘要,如创建,重命名和模式更改。
--patch-with-stat
-p --stat的同义词。
-z
当--raw,--numstat,--name-only或--name-status已给出,非 Munge 时间路径名,并使用完全无效的输出字段终止符。
如果没有这个选项,带有“不寻常”字符的路径名将按照配置变量的说明引用core.quotePath(请参阅 git-config [1])。
--name-only
仅显示已更改文件的名称。
--name-status
仅显示已更改文件的名称和状态。有关--diff-filter状态字母的含义,请参阅选项说明。
--submodule=
指定如何显示子模块中的差异。指定使用--submodule=short的short格式时。这种格式只显示范围开始和结束处的提交名称。当--submodule或者--submodule=log被指定时,使用log格式。这种格式列出了像 git-submodule [1] summary那样的提交。当--submodule=diff指定时,使用diff格式。这种格式显示了提交范围内子模块内容变化的内嵌比较。如果配置选项未设置,则默认为diff.submodule或short格式。
--color=
显示有色差异。--color(即没有=)是一样的--color=always。可以是一个always,never或auto。
--no-color
关闭有色差异。它和--color=never一样。
--word-diff=
显示一个单词 diff,使用分隔已更改的单词。默认情况下,单词由空格分隔; 见--word-diff-regex下文。默认为plain,并且必须是以下之一:
颜色(color )
仅使用颜色突出显示更改的词。意味着--color。
plain
将单词显示为[-removed-]和{+added+}。如果输入中出现分隔符,则不会尝试跳过分隔符,因此输出可能不明确。
porcelain
使用专门用于脚本消费的基于行的格式。以通常的统一差异格式打印已添加/已删除/未更改的运行,以行开头处的+/ -/字符开始并延伸至行尾。输入中~的换行符通过它自己的一行代字符表示。
没有 (none)
再次禁用字差异。
请注意,尽管第一个模式的名称,如果启用,颜色将用于突出显示所有模式中更改的部分。
--word-diff-regex=
使用来决定一个单词是什么,而不是将非空白的运行视为一个单词。也意味着--word-diff除非已经启用。
每个的非重叠匹配都被视为一个单词。为了找到差异,这些匹配之间的任何内容都被认为是空白并被忽略(!)。你可能想追|[^[:space:]]加到你的正则表达式,以确保它匹配所有非空白字符。包含换行符的匹配在换行符处被无提地截断(!)。
例如,--word-diff-regex=.将每个字符看作单词,并相应地逐个字符地显示差异。
正则表达式也可以通过 diff 驱动程序或配置选项来设置,请参阅 gitattributes [5]或 git-config [1]。显式给予它将覆盖任何diff驱动程序或配置设置。差异驱动程序覆盖配置设置
--color-words=
相当于--word-diff=color加号(如果指定了正则表达式)--word-diff-regex=。
--no-renames
关闭重命名检测,即使配置文件提供了默认设置。
--check
警告如果更改引入冲突标记或空白错误。认为空白错误由core.whitespace配置控制。默认情况下,尾随空格(包括单独由空格组成的行)和空格字符(紧跟该行的初始缩进内的制表符后面的空格字符)将被视为空白错误。如果发现问题,则退出非零状态。与--exit-code 不兼容。
--ws-error-highlight=
突出显示空白的错误context,old或者new把差异线。多个值以逗号分隔,none重置以前的值,default将列表重置为new和all简写为old,new,context。如果未给出此选项,并且diff.wsErrorHighlight未设置配置变量,则只会new突出显示行中的空白错误。空白错误是彩色的color.diff.whitespace。
--full-index
在生成补丁格式输出时,在“索引”行上显示完整的映像前和映像后blob对象名称,而不是第一批字符。
--binary
除了--full-index输出可以应用的二进制差异git-apply。
--abbrev=
不是在 diff-raw 格式输出和 diff-tree标题行中显示完整的40字节十六进制对象名称,只显示部分前缀。这与 --full-index上面的选项无关,后者控制 diff-patch 输出格式。非默认的位数可以用指定--abbrev=。
-B--break-rewrites[=]
将完全重写更改分解为删除和创建对。这有两个目的:
它影响到一种改变的方式,这种改变相当于整个文件的重写,而不是像一系列删除和插入混合在一起,只有几行文本与上下文相匹配,但是作为一个单一的删除旧的一切,随后是一个单次插入所有新事物,并且数字m控制-B选项的这个方面(默认为60%)。-B/70%指定只有少于30%的原始数据应保留在Git的结果中,以便将其视为全部重写(否则结果补丁将是一系列与上下文行混合的删除和插入)。
与-M 一起使用时,完全重写的文件也被认为是重命名的来源(通常-M 仅考虑作为重命名源消失的文件),并且该数字n控制着-B选项的这个方面(默认为50%)。-B20%指定添加和删除相对于文件大小的20%或更多的更改有资格作为重命名为其他文件的可能来源。
-M--find-renames=
检测重命名。如果n被指定,则它是相似度指数的阈值(即与文件大小相比的添加/删除量)。例如,-M90%如果超过90%的文件没有改变,Git应该考虑删除/添加对是一个重命名。如果没有%符号,该数字应作为分数读取,并在其前面加小数点。即,-M5变成0.5,并且因此是相同的-M50%。同样的,-M05也是一样的-M5%。要将检测限制为精确重命名,请使用-M100%。默认相似度指数为50%。
-C--find-copies=
检测副本以及重命名。另见--find-copies-harder。如果n被指定,它的含义与-M。
--find-copies-harder
出于性能原因,默认情况下,-C只有当副本的原始文件在相同的变更集中被修改时,选项才会查找副本。该标志使命令检查未修改的文件作为复制源的候选项。对于大型项目来说这是一项非常昂贵的操作,因此请谨慎使用。给予多个-C选项具有相同的效果。
-D --irreversible-delete
省略原图像进行删除,即仅打印标题,但不打印原像和之间的差异/dev/null。由此产生的补丁不适用于patch或git apply; 这仅适用于那些想专注于更改后查看文本的人。另外,输出显然缺乏足够的信息来反向应用这样的补丁,甚至是手动的,因此也就是选项的名称。
在与-B删除/创建对的删除部分一起使用时,还要省略原像。
-l
在-M和-C选项需要为O(n ^ 2)的处理时间,其中n是/复制目标潜在的重命名的数目。如果重命名/复制目标的数量超过指定的数量,则此选项可防止重命名/复制检测运行。
--diff-filter=[(A|C|D|M|R|T|U|X|B)…*]
选择仅添加(A),复制(C),删除(D),修改(M),重命名(R),其类型(即常规文件,符号链接,子模块,...)更改(T),Unmerged(U),未知(X)或已配对Broken(B)。可以使用任何过滤字符的组合(包括无)。当*(全部或无)添加到组合中时,如果有任何文件与比较中的其他条件匹配,则选择所有路径; 如果没有与其他标准匹配的文件,则不会选择任何内容。
此外,这些大写字母可以降低排除。例如--diff-filter=ad排除添加和删除的路径。
-S
查找改变文件中指定字符串出现次数(即添加/删除)的差异。旨在供剧本使用。
当你寻找一个精确的代码块(比如一个结构体)并且想知道该块自第一次出现以来的历史记录时,它非常有用:迭代地使用该特征将原始图像中的有趣块返回到-S,并继续前进,直到获得该块的第一个版本。
-G
寻找补丁文本包含与匹配的添加/删除行的差异。
为了说明之间的区别-S--pickaxe-regex,并-G考虑在同一个文件中的以下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不会(因为该字符串的出现次数没有改变)。
有关pickaxe更多信息,请参阅 gitdiffcore [7]中的条目。
--pickaxe-all
当-S或-G发现更改时,显示该更改集中的所有更改,而不仅仅是包含中的更改的文件。
--pickaxe-regex
将给定的-S视为扩展的 POSIX 正则表达式进行匹配。
-O
控制文件在输出中出现的顺序。这覆盖了diff.orderFile配置变量(请参阅 git-config [1])。取消diff.orderFile,使用-O/dev/null。
输出顺序由中的全局模式顺序决定。所有具有与第一个模式相匹配的路径名的文件将首先输出,接下来将输出所有具有匹配第二个模式(但不是第一个)的路径名的文件,依此类推。最后输出所有不匹配任何模式的路径名的文件,就好像文件末尾有一个隐含的匹配模式一样。如果多个路径名具有相同的排名(它们匹配相同的模式但没有更早的模式),则它们的输出顺序相对于彼此是正常顺序。
按以下方式解析:
空白行被忽略,所以它们可以用作分隔符以提高可读性。以散列(“ #”)开头的行会被忽略,因此它们可以用于注释。\如果以散列开头,则在模式的开头添加反斜杠(“ ”)。每个其他行都包含一个pattern.atterns与没有FNM_PATHNAME标志的fnmantch(3)使用的模式具有相同的语法和语义,除非路径名也匹配模式,如果删除任何数量的最终路径名组件都与该模式匹配。例如,模式“ foo*bar”匹配“ fooasdfbar”和“ foo/bar/baz/asdf”但不是“foobarx即使一行有空白,而另一行没有空白,这也会忽略差异。--ignore-blank-lines忽略其行全部空白的更改。--inter-hunk-context = 在diff hunk之间显示上下文,直到指定的行数,从而融合彼此接近的hunk。默认为diff.interHunkContext如果配置选项未设置,则为0。-W --function-context显示更改的整个周围功能。--exit-code使用类似于diff(1)的代码退出程序。也就是说,如果存在差异,则1退出,0表示没有差异。--quiet禁用程序的所有输出。暗示--exit-code。--ext-diff允许执行一个外部diff助手。如果你用gitattributes [5]设置外部差异驱动程序,你需要在git-log [1]和朋友中使用这个选项。--no-ext-diff不允许外部diff驱动程序。--textconv --no-textconv允许(或不允许)在比较二进制文件时运行外部文本转换过滤器。有关详细信息,请参阅gitattributes [5]。由于textconv过滤器通常是单向转换,因此生成的差异适合人类消费,但无法应用。出于这个原因,默认情况下,textconv过滤器仅针对git-diff [1]和git-log [1]启用,但不适用于git-format-patch [1]或diff plumbing命令。--ignore-submodules = 忽略diff代中子模块的更改。可以是“无”,“未跟踪”,“脏” 或“all”,这是默认设置。如果子模块包含未跟踪或已修改的文件,或者HEAD与超级项目中记录的提交不同,并且可用于覆盖ignore选项在git-config [1]或gitmodules [5]中。当使用“未跟踪”时,如果子模块仅包含未跟踪内容(但仍然针对修改内容进行扫描),则子模块不会被视为脏。使用“dirty”会忽略对子模块工作树的所有更改,只会显示超级项目中存储的提交更改(这是1.7.0之前的行为)。使用“all”隐藏对子模块的所有更改。--src-prefix =
显示给定的源前缀而不是“a /”。--dst-prefix = 显示给定的目标前缀而不是“b /”。--no-prefix不显示任何源或目标前缀。--line-prefix = 为每行输出添加一个附加前缀。--ita -in-in-index默认条目由“git add -N”添加 在“git diff”中显示为现有的空文件,在“git diff --cached”中显示为新文件。该选项使得该条目在“git diff”中显示为新文件,而在“git diff --cached”中不存在。这个选项可以恢复--ita-visible-in-index。这两个选项都是实验性的,可以在将来删除。有关这些常用选项的更详细的解释,请参阅gitdiffcore [7]。-1 - 基-2 - 路-3 - 它们-0分别针对“基本”版本,“我们的分支”或“他们的分支”。使用这些选项,合并条目的差异不会显示出来。默认值是对我们的分支(-2)和完全解析的路径进行差异化。可以给出选项-0以忽略未合并条目的差异输出并仅显示“未合并”。-c --cc比较第2阶段(我们的分支),第3阶段(他们的分支)和工作树文件并输出组合差异,类似于diff-tree用这些标志显示合并提交。-q即使在不存在的文件上仍保持沉默Raw输出格式“git-diff-index”,“git-diff-tree”,“git-diff-files”和“git diff -raw”的原始输出格式非常相似。命令都比较两组事物; 比较不同的是:git-diff-index 比较了和文件系统上的文件。git-diff-index --cached 比较和索引。git-diff-tree -r ...比较由两个参数命名的树。git-diff-files ...比较文件系统上的索引和文件。“git-diff-tree”命令通过打印正在比较的内容的散列来开始输出。之后,a colon.模式为“src”; 000000如果创建或未合并。空间。模式为“dst”; 000000如果删除或未合并。空间。sha1代表“src”; 0 {40}如果创建或未合并。空间。sha1为“dst”; 0 {40}如果创建,不合并或“看工作树”。空间。状态,然后是可选的“分数”编号。选项卡或 NUL -z选项时使用。“src”的路径使用选项卡时-z选项卡或NUL ; 只存在于C或R.“dst”的路径; 只存在于 C 或R.使用 LF 或 NUL -z选项时,可以终止记录。
可能的状态字母是:A:添加一个文件C:将文件复制到新文件中D:删除文件M:修改文件的内容或模式R:重命名文件T:改变文件的类型U:文件未合并(必须先完成合并,然后才能提交)X:“未知”更改类型(最可能是一个错误,请报告)
状态字母 C 和 R 总是跟着一个分数(表示移动或复制的来源和目标之间的相似百分比)。状态字母 M 后可以跟一个文件重写的分数(表示不相似性的百分比)。
如果文件是文件系统上的新文件并且与索引不同步,则显示为全0。
示例::100644 100644 5be4a4...... 000000...... M file.c
如果没有这个-z选项,带有“不寻常”字符的路径名将按照配置变量的说明引用core.quotePath(请参阅 git-config [1])。使用-z文件名是逐字输出的,并且该行由 NUL 字节终止。
比较格式的合并
"git-diff-tree", "git-diff-files" and "git-diff --raw" 可以采取-c或--cc选项,也产生差异输出合并提交。输出与上述格式的不同之处在于:
每个父母都有一个冒号还有更多的“src”模式和“src”sha1状态是每个父级的连接状态字符没有可选的“分数”号码单个路径,仅适用于“dst”示例::: 100644 100644 100644 fabadb8 ... cc95eb0 ... 4866510 ... MM describe.c 注意:combined 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格式略有不同:它前面有一个“git diff”头,看起来像这样:
diff --git a/file1 b/file2
在a/和b/文件名是,除非重命名/副本所涉及的相同。尤其是,即使是创建或删除,/dev/null也可not用于替换文件名a/或b/文件名。
当重命名/复制参与,file1和file2示出了重命名/复制的源文件的名称和重命名/复制分别产生,该文件的名称。
它后跟一个或多个扩展标题行:旧模式新模式已删除文件模式新文件模式从复制到从重命名重命名为相似索引不相似索引索引.. 文件模式打印为6位八进制数字,包括文件类型和文件权限位。扩展头中的路径名不包含a/和b/前缀。相似性指数是未改变的行的百分比,不相似性指数是改变的行的百分比。它是一个向下舍入的整数,后面跟着一个百分号。100%的相似性指数值因此保留给两个相同的文件,而100%相异性意味着来自旧文件的任何行都不会将其转换为新的文件。索引行包含更改前后的 SHA-1校验和。如果文件模式没有改变,则包含; 否则,单独的行表示旧模式和新模式。带有“不常用”字符的路径名将按照配置变量的说明引用core.quotePath(请参阅git-config [1])。file1输出中的所有文件在提交之前引用文件,所有file2文件在提交之后引用文件。将每个更改顺序应用于每个文件是不正确的。例如,这个补丁会将a和b:diff --git a / ab / b重命名为a重命名为b diff --git a / bb / a重命名为b重命名为 aCombined diff formatAny diff-generating 命令可以将-c或者显示合并时--cc产生一个选项combined diff。这是显示与 git-diff [1]或 git-show [1]合并时的默认格式。另请注意,您可以-m选择这些命令中的任何一个来强制生成合并的单个父代的差异combined 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; } - 静态void描述(char * arg) - 静态void描述(struct commit * cmit,int last_one)++静态void描述(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 --组合文件
或者像这样(当使用--cc选项时):
diff --cc 文件
它后面跟着一个或多个扩展标题行(此示例显示与两个父级合并):index ,.. mode ,.. 新文件模式已删除的文件模式,mode ,..只有当至少有一个与其余部分不同时,该行才会出现。具有关于检测到的内容移动(重命名和复制检测)的信息的扩展标题被设计为与两个的差异一起工作,并且不被组合的差异格式使用。紧接着是两行文件/文件头
--- a /文件+++ b /文件
类似于传统unified差异格式的双行标题,/dev/null用于表示创建或删除的文件。
块头格式被修改以防止人们意外地将其提供给patch -p1。组合的差异格式是为了审查合并提交更改而创建的,并不适用于应用。这个改变类似于扩展index头中的改变:@@@ @@@有(父数+ 1)个@字符不同于传统的unifieddiff格式,它显示两个文件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 aka“我们的版本”,file2是阶段3 aka“他们的版本”)其他diff格式该--summary选项描述新添加,删除,重命名并复制文件。该--stat选项将diffstat(1)图添加到输出。这些选项可以与其他选项结合使用,如-p用于人类消费。当显示涉及重命名或复制的更改时,--stat输出通过结合路径名的通用前缀和后缀来紧凑地格式化路径名。例如,移动的改变arch/i386/Makefile,以arch/x86/Makefile在修改4线将示出这样的:拱/ {I386 => 86} /生成文件| 4 + - 该--numstat选项提供了diffstat(1)信息,但设计用于更简单的机器消耗。--numstat输出中的条目如下所示:1 2自述文件3 1 arch / {i386 => x86} / Makefile即从左至右:增加的行数;标签;删除的行数;标签;路径名(可能带有重命名/复制信息);一个换行符。当-z输出选项有效时,输出格式如下:1 2 README NUL 3 1 NUL arch / i386 / Makefile NUL arch / x86 / Makefile NULThat 是:增加的行数;标签;删除的行数;标签;NUL(只有在重命名/复制时才存在);preimage 中的路径名;NUL(只有在重命名/复制时才存在);postimage 中的路径名(只有在重命名/复制时才存在);a NUL.
NUL重命名之前的 preimage 路径之前的额外内容是允许读取输出的脚本判断当前正在读取的记录是单路径记录还是重命名/复制记录,而不提前读取。阅读添加和删除的行后,读取NUL会产生路径名,但如果是这样NUL,该记录将显示两个路径。