名稱（Name）

git-diff-files  - 比較工作樹和索引中的文件

概要

git diff-files [-q] [-0|-1|-2|-3|-c|--cc] [<common diff options>] [<path>…]

描述

比較工作樹中的文件和索引。當(dāng)指定路徑時，只比較那些命名的路徑。否則，將比較索引中的所有條目。輸出格式是一樣的git diff-index和git diff-tree。

選項

-p   -u   --patch

生成補(bǔ)?。ㄕ垍㈤喩裳a(bǔ)丁一節(jié)）。

-s   --no-patch

抑制差異輸出。對于像git show這樣的命令很有用，默認(rèn)顯示補(bǔ)丁，或者取消--patch效果。

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

使用<n>行上下文生成差異，而不是通常的三行。意味著-p。

--raw

以原始格式生成差異。這是默認(rèn)設(shè)置。

--patch-with-raw

-p --raw的同義詞。

- 縮進(jìn) - 啟發(fā)式 - 不縮進(jìn) - 啟發(fā)式   （ --indent-heuristic   --no-indent-heuristic）

這些是為了幫助調(diào)試和調(diào)整實驗啟發(fā)式（默認(rèn)情況下是關(guān)閉的），這些啟發(fā)式技術(shù)改變了差異邊界以使修補(bǔ)程序更易于閱讀。

--minimal

花費額外的時間來確保生成最小可能的差異。

--patience

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

--histogram

使用“直方圖差異”算法生成差異。

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

選擇一種差異算法。變體如下：

default, myers

基本的貪婪 diff 算法。目前，這是默認(rèn)設(shè)置。

minimal

花費額外的時間來確保生成最小可能的差異。

patience

生成補(bǔ)丁時使用“耐心差異”算法。

histogram

該算法將耐心算法擴(kuò)展為“支持低出現(xiàn)率的通用元素”。

例如，如果您將 diff.algorithm 變量配置為非默認(rèn)值并且想要使用默認(rèn)值，那么您必須使用--diff-algorithm=default選項。

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

生成一個 diffstat。默認(rèn)情況下，文件名部分使用盡可能多的空間，其余部分使用圖形部分。最大寬度默認(rèn)為終端寬度，如果未連接到終端，則最大寬度為80列，并且可以被覆蓋<width>。文件名部分的寬度可以通過<name-width>逗號后面的另一個寬度來限制。圖形部分的寬度可以通過使用--stat-graph-width=<width>（影響所有生成統(tǒng)計圖的命令）或通過設(shè)置diff.statGraphWidth=<width>（不影響git format-patch）來限制。通過給出第三個參數(shù)<count>，可以將輸出限制在第一<count>行，...如果還有更多的話。

這些參數(shù)也可以單獨設(shè)置--stat-width=<width>，--stat-name-width=<name-width>和--stat-count=<count>。

--numstat

類似于--stat，但顯示十進(jìn)制表示法中添加和刪除的行數(shù)以及不帶縮寫的路徑名，以使其更加機(jī)器友好。對于二進(jìn)制文件，輸出兩個-而不是說0 0。

--shortstat

只輸出--stat包含修改文件總數(shù)的格式的最后一行，以及添加和刪除行的數(shù)量。

--dirstat=<param1,param2,…>

輸出每個子目錄的相對變化量分布。--dirstat可以通過傳遞逗號分隔的參數(shù)列表來定制行為。默認(rèn)值由diff.dirstat配置變量控制（請參閱 git-config [1]）。以下參數(shù)可用：

changes

通過計算已從源中刪除或添加到目標(biāo)的行來計算 dirstat 數(shù)字。這會忽略文件中純代碼移動的數(shù)量。換句話說，重新排列文件中的行數(shù)不會與其他更改一樣多。這是沒有給出參數(shù)時的默認(rèn)行為。

lines

通過執(zhí)行常規(guī)基于行的差異分析來計算dirstat數(shù)字，并將刪除/添加的行數(shù)相加。（對于二進(jìn)制文件，取而代之的是計算64字節(jié)的塊，因為二進(jìn)制文件沒有自然的行概念）。這是一種--dirstat比changes行為更為昂貴的行為，但它可以像其他更改一樣計算文件中重新排列的行數(shù)。結(jié)果輸出與您從其他--*stat選項中獲得的結(jié)果一致。

files

通過計算更改的文件數(shù)量來計算 dirstat 數(shù)字。dirstat 分析中每個更改的文件都相同。這是計算上最便宜的--dirstat行為，因為它不必查看文件內(nèi)容。

cumulative

計數(shù)父目錄的子目錄中的更改。請注意，使用時cumulative，報告的百分比總和可能超過100％。默認(rèn)（非累積）行為可以用noncumulative參數(shù)指定。

<limit>

整數(shù)參數(shù)指定截斷百分比（默認(rèn)為3％）。輸出中不顯示貢獻(xiàn)小于此百分比的目錄。

示例：以下內(nèi)容將計數(shù)已更改的文件，同時忽略占已更改文件總數(shù)少于10％的目錄，并累積父目錄中的子目錄計數(shù)：--dirstat=files,10,cumulative。

--summary

輸出擴(kuò)展頭信息的精簡摘要，如創(chuàng)建，重命名和模式更改。

--patch-with-stat

-p --stat的同義詞。

-z

當(dāng)--raw，--numstat，--name-only或--name-status已給出，非 Munge 時間路徑名，并使用完全無效的輸出字段終止符。

如果沒有這個選項，帶有“不尋常”字符的路徑名將按照配置變量的說明引用core.quotePath（請參閱 git-config [1]）。

--name-only

僅顯示已更改文件的名稱。

--name-status

僅顯示已更改文件的名稱和狀態(tài)。有關(guān)--diff-filter狀態(tài)字母的含義，請參閱選項說明。

--submodule=<format>

指定如何顯示子模塊中的差異。指定使用--submodule=short的short格式時。這種格式只顯示范圍開始和結(jié)束處的提交名稱。當(dāng)--submodule或者--submodule=log被指定時，使用log格式。這種格式列出了像 git-submodule [1] summary那樣的提交。當(dāng)--submodule=diff指定時，使用diff格式。這種格式顯示了提交范圍內(nèi)子模塊內(nèi)容變化的內(nèi)嵌比較。如果配置選項未設(shè)置，則默認(rèn)為diff.submodule或short格式。

--color=<when>

顯示有色差異。--color（即沒有=<when>）是一樣的--color=always。<when>可以是一個always，never或auto。

--no-color

關(guān)閉有色差異。它和--color=never一樣。

--word-diff=<mode>

顯示一個單詞 diff，使用<mode>分隔已更改的單詞。默認(rèn)情況下，單詞由空格分隔; 見--word-diff-regex下文。<mode>默認(rèn)為plain，并且必須是以下之一：

顏色（color ）

僅使用顏色突出顯示更改的詞。意味著--color。

plain

將單詞顯示為[-removed-]和{+added+}。如果輸入中出現(xiàn)分隔符，則不會嘗試跳過分隔符，因此輸出可能不明確。

porcelain

使用專門用于腳本消費的基于行的格式。以通常的統(tǒng)一差異格式打印已添加/已刪除/未更改的運行，以行開頭處的+/ -/字符開始并延伸至行尾。輸入中~的換行符通過它自己的一行代字符表示。

沒有 （none）

再次禁用字差異。

請注意，盡管第一個模式的名稱，如果啟用，顏色將用于突出顯示所有模式中更改的部分。

--word-diff-regex=<regex>

使用<regex>來決定一個單詞是什么，而不是將非空白的運行視為一個單詞。也意味著--word-diff除非已經(jīng)啟用。

每個<regex>的非重疊匹配都被視為一個單詞。為了找到差異，這些匹配之間的任何內(nèi)容都被認(rèn)為是空白并被忽略（?。?。你可能想追|[^[:space:]]加到你的正則表達(dá)式，以確保它匹配所有非空白字符。包含換行符的匹配在換行符處被無提地截斷（?。?。

例如，--word-diff-regex=.將每個字符看作單詞，并相應(yīng)地逐個字符地顯示差異。

正則表達(dá)式也可以通過 diff 驅(qū)動程序或配置選項來設(shè)置，請參閱 gitattributes [5]或 git-config [1]。顯式給予它將覆蓋任何diff驅(qū)動程序或配置設(shè)置。差異驅(qū)動程序覆蓋配置設(shè)置

--color-words=<regex>

相當(dāng)于--word-diff=color加號（如果指定了正則表達(dá)式）--word-diff-regex=<regex>。

--no-renames

關(guān)閉重命名檢測，即使配置文件提供了默認(rèn)設(shè)置。

--check

警告如果更改引入沖突標(biāo)記或空白錯誤。認(rèn)為空白錯誤由core.whitespace配置控制。默認(rèn)情況下，尾隨空格（包括單獨由空格組成的行）和空格字符（緊跟該行的初始縮進(jìn)內(nèi)的制表符后面的空格字符）將被視為空白錯誤。如果發(fā)現(xiàn)問題，則退出非零狀態(tài)。與--exit-code 不兼容。

--ws-error-highlight=<kind>

突出顯示空白的錯誤context，old或者new把差異線。多個值以逗號分隔，none重置以前的值，default將列表重置為new和all簡寫為old,new,context。如果未給出此選項，并且diff.wsErrorHighlight未設(shè)置配置變量，則只會new突出顯示行中的空白錯誤?？瞻族e誤是彩色的color.diff.whitespace。

--full-index

在生成補(bǔ)丁格式輸出時，在“索引”行上顯示完整的映像前和映像后blob對象名稱，而不是第一批字符。

--binary

除了--full-index輸出可以應(yīng)用的二進(jìn)制差異git-apply。

--abbrev=<n>

不是在 diff-raw 格式輸出和 diff-tree標(biāo)題行中顯示完整的40字節(jié)十六進(jìn)制對象名稱，只顯示部分前綴。這與 --full-index上面的選項無關(guān)，后者控制 diff-patch 輸出格式。非默認(rèn)的位數(shù)可以用指定--abbrev=<n>。

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

將完全重寫更改分解為刪除和創(chuàng)建對。這有兩個目的：

它影響到一種改變的方式，這種改變相當(dāng)于整個文件的重寫，而不是像一系列刪除和插入混合在一起，只有幾行文本與上下文相匹配，但是作為一個單一的刪除舊的一切，隨后是一個單次插入所有新事物，并且數(shù)字m控制-B選項的這個方面（默認(rèn)為60％）。-B/70%指定只有少于30％的原始數(shù)據(jù)應(yīng)保留在Git的結(jié)果中，以便將其視為全部重寫（否則結(jié)果補(bǔ)丁將是一系列與上下文行混合的刪除和插入）。

與-M 一起使用時，完全重寫的文件也被認(rèn)為是重命名的來源（通常-M 僅考慮作為重命名源消失的文件），并且該數(shù)字n控制著-B選項的這個方面（默認(rèn)為50％）。-B20%指定添加和刪除相對于文件大小的20％或更多的更改有資格作為重命名為其他文件的可能來源。

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

檢測重命名。如果n被指定，則它是相似度指數(shù)的閾值（即與文件大小相比的添加/刪除量）。例如，-M90%如果超過90％的文件沒有改變，Git應(yīng)該考慮刪除/添加對是一個重命名。如果沒有%符號，該數(shù)字應(yīng)作為分?jǐn)?shù)讀取，并在其前面加小數(shù)點。即，-M5變成0.5，并且因此是相同的-M50%。同樣的，-M05也是一樣的-M5%。要將檢測限制為精確重命名，請使用-M100%。默認(rèn)相似度指數(shù)為50％。

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

檢測副本以及重命名。另見--find-copies-harder。如果n被指定，它的含義與-M<n>。

--find-copies-harder

出于性能原因，默認(rèn)情況下，-C只有當(dāng)副本的原始文件在相同的變更集中被修改時，選項才會查找副本。該標(biāo)志使命令檢查未修改的文件作為復(fù)制源的候選項。對于大型項目來說這是一項非常昂貴的操作，因此請謹(jǐn)慎使用。給予多個-C選項具有相同的效果。

-D   --irreversible-delete

省略原圖像進(jìn)行刪除，即僅打印標(biāo)題，但不打印原像和之間的差異/dev/null。由此產(chǎn)生的補(bǔ)丁不適用于patch或git apply; 這僅適用于那些想專注于更改后查看文本的人。另外，輸出顯然缺乏足夠的信息來反向應(yīng)用這樣的補(bǔ)丁，甚至是手動的，因此也就是選項的名稱。

在與-B刪除/創(chuàng)建對的刪除部分一起使用時，還要省略原像。

-l<num>

在-M和-C選項需要為O（n ^ 2）的處理時間，其中n是/復(fù)制目標(biāo)潛在的重命名的數(shù)目。如果重命名/復(fù)制目標(biāo)的數(shù)量超過指定的數(shù)量，則此選項可防止重命名/復(fù)制檢測運行。

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

選擇僅添加（A），復(fù)制（C），刪除（D），修改（M），重命名（R），其類型（即常規(guī)文件，符號鏈接，子模塊，...）更改（T），Unmerged（U），未知（X）或已配對Broken（B）?？梢允褂萌魏芜^濾字符的組合（包括無）。當(dāng)*（全部或無）添加到組合中時，如果有任何文件與比較中的其他條件匹配，則選擇所有路徑; 如果沒有與其他標(biāo)準(zhǔn)匹配的文件，則不會選擇任何內(nèi)容。

此外，這些大寫字母可以降低排除。例如--diff-filter=ad排除添加和刪除的路徑。

-S<string>

查找改變文件中指定字符串出現(xiàn)次數(shù)（即添加/刪除）的差異。旨在供劇本使用。

當(dāng)你尋找一個精確的代碼塊（比如一個結(jié)構(gòu)體）并且想知道該塊自第一次出現(xiàn)以來的歷史記錄時，它非常有用：迭代地使用該特征將原始圖像中的有趣塊返回到-S，并繼續(xù)前進(jìn)，直到獲得該塊的第一個版本。

-G<regex>

尋找補(bǔ)丁文本包含與<regex>匹配的添加/刪除行的差異。

為了說明之間的區(qū)別-S<regex> --pickaxe-regex，并-G<regex>考慮在同一個文件中的以下DIFF提交：

+    return !regexec(regexp, two->ptr, 1, &regmatch, 0);...-    hit = !regexec(regexp, mf2.ptr, 1, &regmatch, 0);

雖然git log -G"regexec\(regexp"會顯示此提交，但git log -S"regexec\(regexp" --pickaxe-regex不會（因為該字符串的出現(xiàn)次數(shù)沒有改變）。

有關(guān)pickaxe更多信息，請參閱 gitdiffcore [7]中的條目。

--pickaxe-all

當(dāng)-S或-G發(fā)現(xiàn)更改時，顯示該更改集中的所有更改，而不僅僅是包含<string>中的更改的文件。

--pickaxe-regex

將給定的<string> -S視為擴(kuò)展的 POSIX 正則表達(dá)式進(jìn)行匹配。

-O<orderfile>

控制文件在輸出中出現(xiàn)的順序。這覆蓋了diff.orderFile配置變量（請參閱 git-config [1]）。取消diff.orderFile，使用-O/dev/null。

輸出順序由<orderfile>中的全局模式順序決定。所有具有與第一個模式相匹配的路徑名的文件將首先輸出，接下來將輸出所有具有匹配第二個模式（但不是第一個）的路徑名的文件，依此類推。最后輸出所有不匹配任何模式的路徑名的文件，就好像文件末尾有一個隱含的匹配模式一樣。如果多個路徑名具有相同的排名（它們匹配相同的模式但沒有更早的模式），則它們的輸出順序相對于彼此是正常順序。

按以下方式解析<orderfile>：

• 空白行被忽略，所以它們可以用作分隔符以提高可讀性。

• 以散列（“ #”）開頭的行會被忽略，因此它們可以用于注釋。\如果以散列開頭，則在模式的開頭添加反斜杠（“ ”）。

• 每個其他行都包含一個pattern.atterns與沒有FNM_PATHNAME標(biāo)志的fnmantch（3）使用的模式具有相同的語法和語義，除非路徑名也匹配模式，如果刪除任何數(shù)量的最終路徑名組件都與該模式匹配。例如，模式“ foo*bar”匹配“ fooasdfbar”和“ foo/bar/baz/asdf”但不是“foobarx即使一行有空白，而另一行沒有空白，這也會忽略差異。--ignore-blank-lines忽略其行全部空白的更改。--inter-hunk-context = <lines>在diff hunk之間顯示上下文，直到指定的行數(shù)，從而融合彼此接近的hunk。默認(rèn)為diff.interHunkContext如果配置選項未設(shè)置，則為0。-W --function-context顯示更改的整個周圍功能。--exit-code使用類似于diff（1）的代碼退出程序。也就是說，如果存在差異，則1退出，0表示沒有差異。--quiet禁用程序的所有輸出。暗示--exit-code。--ext-diff允許執(zhí)行一個外部diff助手。如果你用gitattributes [5]設(shè)置外部差異驅(qū)動程序，你需要在git-log [1]和朋友中使用這個選項。--no-ext-diff不允許外部diff驅(qū)動程序。--textconv --no-textconv允許（或不允許）在比較二進(jìn)制文件時運行外部文本轉(zhuǎn)換過濾器。有關(guān)詳細(xì)信息，請參閱gitattributes [5]。由于textconv過濾器通常是單向轉(zhuǎn)換，因此生成的差異適合人類消費，但無法應(yīng)用。出于這個原因，默認(rèn)情況下，textconv過濾器僅針對git-diff [1]和git-log [1]啟用，但不適用于git-format-patch [1]或diff plumbing命令。--ignore-submodules = <when>忽略diff代中子模塊的更改。<什么時候>可以是“無”，“未跟蹤”，“臟” 或“all”，這是默認(rèn)設(shè)置。如果子模塊包含未跟蹤或已修改的文件，或者HEAD與超級項目中記錄的提交不同，并且可用于覆蓋ignore選項在git-config [1]或gitmodules [5]中。當(dāng)使用“未跟蹤”時，如果子模塊僅包含未跟蹤內(nèi)容（但仍然針對修改內(nèi)容進(jìn)行掃描），則子模塊不會被視為臟。使用“dirty”會忽略對子模塊工作樹的所有更改，只會顯示超級項目中存儲的提交更改（這是1.7.0之前的行為）。使用“all”隱藏對子模塊的所有更改。--src-prefix = <prefix>顯示給定的源前綴而不是“a /”。--dst-prefix = <prefix>顯示給定的目標(biāo)前綴而不是“b /”。--no-prefix不顯示任何源或目標(biāo)前綴。--line-prefix = <prefix>為每行輸出添加一個附加前綴。--ita -in-in-index默認(rèn)條目由“git add -N”添加 在“git diff”中顯示為現(xiàn)有的空文件，在“git diff --cached”中顯示為新文件。該選項使得該條目在“git diff”中顯示為新文件，而在“git diff --cached”中不存在。這個選項可以恢復(fù)--ita-visible-in-index。這兩個選項都是實驗性的，可以在將來刪除。有關(guān)這些常用選項的更詳細(xì)的解釋，請參閱gitdiffcore [7]。-1  - 基-2  - 路-3  - 它們-0分別針對“基本”版本，“我們的分支”或“他們的分支”。使用這些選項，合并條目的差異不會顯示出來。默認(rèn)值是對我們的分支（-2）和完全解析的路徑進(jìn)行差異化。可以給出選項-0以忽略未合并條目的差異輸出并僅顯示“未合并”。-c --cc比較第2階段（我們的分支），第3階段（他們的分支）和工作樹文件并輸出組合差異，類似于diff-tree用這些標(biāo)志顯示合并提交。-q即使在不存在的文件上仍保持沉默Raw輸出格式“git-diff-index”，“git-diff-tree”，“git-diff-files”和“git diff -raw”的原始輸出格式非常相似。命令都比較兩組事物; 比較不同的是：git-diff-index <tree-ish>比較了<tree-ish>和文件系統(tǒng)上的文件。git-diff-index --cached <tree-ish>比較<tree-ish>和索引。git-diff-tree -r <tree-ish-1> <tree-ish-2> <pattern> ...比較由兩個參數(shù)命名的樹。git-diff-files <pattern> ...比較文件系統(tǒng)上的索引和文件?！癵it-diff-tree”命令通過打印正在比較的內(nèi)容的散列來開始輸出。之后，

• a colon.

1. 模式為“src”; 000000如果創(chuàng)建或未合并。

1. 空間。

1. 模式為“dst”; 000000如果刪除或未合并。

1. 空間。

1. sha1代表“src”; 0 {40}如果創(chuàng)建或未合并。

1. 空間。

1. sha1為“dst”; 0 {40}如果創(chuàng)建，不合并或“看工作樹”。

1. 空間。

1. 狀態(tài)，然后是可選的“分?jǐn)?shù)”編號。

1. 選項卡或 NUL -z選項時使用。

1. “src”的路徑

1. 使用選項卡時-z選項卡或NUL ; 只存在于C或R.

1. “dst”的路徑; 只存在于 C 或R.

1. 使用 LF 或 NUL -z選項時，可以終止記錄。

可能的狀態(tài)字母是：

• A：添加一個文件

• C：將文件復(fù)制到新文件中

• D：刪除文件

• M：修改文件的內(nèi)容或模式

• R：重命名文件

• T：改變文件的類型

• U：文件未合并（必須先完成合并，然后才能提交）

• X：“未知”更改類型（最可能是一個錯誤，請報告）

狀態(tài)字母 C 和 R 總是跟著一個分?jǐn)?shù)（表示移動或復(fù)制的來源和目標(biāo)之間的相似百分比）。狀態(tài)字母 M 后可以跟一個文件重寫的分?jǐn)?shù)（表示不相似性的百分比）。

如果文件是文件系統(tǒng)上的新文件并且與索引不同步，則<sha1>顯示為全0。

示例:

:100644 100644 5be4a4...... 000000...... M file.c

如果沒有這個-z選項，帶有“不尋常”字符的路徑名將按照配置變量的說明引用core.quotePath（請參閱 git-config [1]）。使用-z文件名是逐字輸出的，并且該行由 NUL 字節(jié)終止。

比較格式的合并

"git-diff-tree", "git-diff-files" and "git-diff --raw" 可以采取-c或--cc選項，也產(chǎn)生差異輸出合并提交。輸出與上述格式的不同之處在于：

1. 每個父母都有一個冒號

1. 還有更多的“src”模式和“src”sha1

1. 狀態(tài)是每個父級的連接狀態(tài)字符

1. 沒有可選的“分?jǐn)?shù)”號碼

1. 單個路徑，僅適用于“dst”示例::: 100644 100644 100644 fabadb8 ... cc95eb0 ... 4866510 ... MM describe.c 注意：combined diff僅列出所有父母修改過的文件。使用-p 生成補(bǔ)丁程序當(dāng)使用“git- diff-index“，”git-diff-tree“或者”git-diff-files“可以通過-p選項運行，”git diff“不帶--raw選項，或者”git log“用”-p“選項運行不產(chǎn)生上述輸出; 相反，他們生成一個補(bǔ)丁文件。您可以通過GIT_EXTERNAL_DIFF和GIT_DIFF_OPTS環(huán)境變量自定義這些修補(bǔ)程序的創(chuàng)建。-p選項生成的內(nèi)容與傳統(tǒng)的diff格式略有不同：

1. 它前面有一個“git diff”頭，看起來像這樣：

diff --git a/file1 b/file2

在a/和b/文件名是，除非重命名/副本所涉及的相同。尤其是，即使是創(chuàng)建或刪除，/dev/null也可not用于替換文件名a/或b/文件名。

當(dāng)重命名/復(fù)制參與，file1和file2示出了重命名/復(fù)制的源文件的名稱和重命名/復(fù)制分別產(chǎn)生，該文件的名稱。

1. 它后跟一個或多個擴(kuò)展標(biāo)題行：舊模式<mode>新模式<mode>已刪除文件模式<mode>新文件模式<mode>從<path>復(fù)制到<path>從<path>重命名重命名為<path>相似索引<number>不相似索引<number>索引<hash> .. <hash> <mode>文件模式打印為6位八進(jìn)制數(shù)字，包括文件類型和文件權(quán)限位。擴(kuò)展頭中的路徑名不包含a/和b/前綴。相似性指數(shù)是未改變的行的百分比，不相似性指數(shù)是改變的行的百分比。它是一個向下舍入的整數(shù)，后面跟著一個百分號。100％的相似性指數(shù)值因此保留給兩個相同的文件，而100％相異性意味著來自舊文件的任何行都不會將其轉(zhuǎn)換為新的文件。索引行包含更改前后的 SHA-1校驗和。如果文件模式?jīng)]有改變，則包含<mode>; 否則，單獨的行表示舊模式和新模式。

1. 帶有“不常用”字符的路徑名將按照配置變量的說明引用core.quotePath（請參閱git-config [1]）。

1. file1輸出中的所有文件在提交之前引用文件，所有file2文件在提交之后引用文件。將每個更改順序應(yīng)用于每個文件是不正確的。例如，這個補(bǔ)丁會將a和b：diff --git a / ab / b重命名為a重命名為b diff --git a / bb / a重命名為b重命名為 aCombined diff formatAny diff-generating 命令可以將-c或者顯示合并時--cc產(chǎn)生一個選項combined diff。這是顯示與 git-diff [1]或 git-show [1]合并時的默認(rèn)格式。另請注意，您可以-m選擇這些命令中的任何一個來強(qiáng)制生成合并的單個父代的差異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; }  - 靜態(tài)void描述（char * arg） - 靜態(tài)void描述（struct commit * cmit，int last_one）++靜態(tài)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）;

1. 它前面有一個“git diff”頭，看起來像這樣（當(dāng)使用-c選項時）：

差異diff --組合文件

或者像這樣（當(dāng)使用--cc選項時）：

diff --cc 文件

1. 它后面跟著一個或多個擴(kuò)展標(biāo)題行（此示例顯示與兩個父級合并）：index <hash>，<hash> .. <hash> mode <mode>，<mode> .. <mode>新文件模式<mode>已刪除的文件模式<mode>，<mode> mode <mode>,<mode>..<mode>只有當(dāng)至少有一個<mode>與其余部分不同時，該行才會出現(xiàn)。具有關(guān)于檢測到的內(nèi)容移動（重命名和復(fù)制檢測）的信息的擴(kuò)展標(biāo)題被設(shè)計為與兩個<tree-ish>的差異一起工作，并且不被組合的差異格式使用。

1. 緊接著是兩行文件/文件頭

--- a /文件+++ b /文件

類似于傳統(tǒng)unified差異格式的雙行標(biāo)題，/dev/null用于表示創(chuàng)建或刪除的文件。

1. 塊頭格式被修改以防止人們意外地將其提供給patch -p1。組合的差異格式是為了審查合并提交更改而創(chuàng)建的，并不適用于應(yīng)用。這個改變類似于擴(kuò)展index頭中的改變：@@@ <從文件范圍到<從文件范圍到<到文件范圍> @@@有（父數(shù)+ 1）個@字符不同于傳統(tǒng)的unifieddiff格式，它顯示兩個文件A和B，其中一個列有-（減號 - 出現(xiàn)在A中，但在B中刪除），+（加 - 在A中丟失，但添加到B中） ， 要么" "（空格不變）前綴，此格式將兩個或多個文件file1，file2，...與一個文件X進(jìn)行比較，并顯示X與每個fileN的區(qū)別。每個fileN的一列都被預(yù)置在輸出行中，以指出X的行與其不同。-列N中的一個字符表示行出現(xiàn)在fileN 中，但它不出現(xiàn)在結(jié)果中。+N列中的一個字符表示該行出現(xiàn)在結(jié)果中，而fileN沒有該行（換句話說，從該父母的視角添加該行）。在上面的示例輸出中，函數(shù)簽名從兩個文件中更改（因此-從file1和file2中刪除了兩個刪除，另外還有兩個刪除++意味著添加的一行不會出現(xiàn)在file1或file2中）。另外還有八行與file1相同，但不會出現(xiàn)在file2中（因此前綴為+）。當(dāng)顯示時git diff-tree -c，它將合并提交的父項與合并結(jié)果（即file1..fileN是父項）進(jìn)行比較。在顯示時git diff-files -c，它將兩個未解決的合并父項與正在運行的樹文件進(jìn)行比較（即，file1是階段2 aka“我們的版本”，file2是階段3 aka“他們的版本”）其他diff格式該--summary選項描述新添加，刪除，重命名并復(fù)制文件。該--stat選項將diffstat（1）圖添加到輸出。這些選項可以與其他選項結(jié)合使用，如-p用于人類消費。當(dāng)顯示涉及重命名或復(fù)制的更改時，--stat輸出通過結(jié)合路徑名的通用前綴和后綴來緊湊地格式化路徑名。例如，移動的改變arch/i386/Makefile，以arch/x86/Makefile在修改4線將示出這樣的：拱/ {I386 => 86} /生成文件| 4 +  - 該--numstat選項提供了diffstat（1）信息，但設(shè)計用于更簡單的機(jī)器消耗。--numstat輸出中的條目如下所示：1 2自述文件3 1 arch / {i386 => x86} / Makefile即從左至右：

1. 增加的行數(shù);

1. 標(biāo)簽;

1. 刪除的行數(shù);

1. 標(biāo)簽;

1. 路徑名（可能帶有重命名/復(fù)制信息）;

1. 一個換行符。當(dāng)-z輸出選項有效時，輸出格式如下：1 2 README NUL 3 1 NUL arch / i386 / Makefile NUL arch / x86 / Makefile NULThat 是：

1. 增加的行數(shù);

1. 標(biāo)簽;

1. 刪除的行數(shù);

1. 標(biāo)簽;

1. NUL（只有在重命名/復(fù)制時才存在）;

1. preimage 中的路徑名;

1. NUL（只有在重命名/復(fù)制時才存在）;

1. postimage 中的路徑名（只有在重命名/復(fù)制時才存在）;

1. a NUL.

NUL重命名之前的 preimage 路徑之前的額外內(nèi)容是允許讀取輸出的腳本判斷當(dāng)前正在讀取的記錄是單路徑記錄還是重命名/復(fù)制記錄，而不提前讀取。閱讀添加和刪除的行后，讀取NUL會產(chǎn)生路徑名，但如果是這樣NUL，該記錄將顯示兩個路徑。