簡體中文 ▾ 主題 ▾ 最新版本 ▾ git-diff-files 上次更新於 2.48.0

名稱

git-diff-files - 比較工作區和索引中的檔案

概要

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

描述

比較工作區和索引中的檔案。如果指定了路徑，則只比較這些命名路徑。否則，比較索引中的所有條目。輸出格式與 git diff-index 和 git diff-tree 相同。

選項

-p
-u
--patch

生成補丁（參見 使用 -p 生成補丁文字）。

-s
--no-patch

禁止所有來自差異機制的輸出。對於像 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

以原始格式生成 diff。這是預設設定。

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

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

default
myers

基本的貪婪差異演算法。目前，這是預設值。

minimal

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

patience

生成補丁時使用“patience diff”演算法。

histogram

此演算法擴充套件了 patience 演算法以“支援低出現率的常見元素”。

例如，如果您將 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 分別用於新增或刪除可執行位）。資訊放在檔名部分和圖形部分之間。隱含 --stat。

--numstat

與 --stat 類似，但以十進位制表示法顯示新增和刪除的行數，並且不縮寫路徑名，以使其更便於機器處理。對於二進位制檔案，輸出兩個 - 而不是 0 0。

--shortstat

僅輸出 --stat 格式的最後一行，其中包含修改檔案的總數，以及新增和刪除的行數。

-X [<param>,...]
--dirstat[=<param>,...]

輸出每個子目錄的相對變化量分佈。--dirstat 的行為可以透過傳遞逗號分隔的引數列表進行自定義。預設值由 diff.dirstat 配置變數控制（參見 git-config[1]）。可用的引數如下：

changes

透過計算從原始檔中移除或新增到目標檔案中的行數來計算目錄統計數字。這會忽略檔案內部純程式碼移動的數量。換句話說，檔案中的行重新排列不會像其他更改那樣被計算。這是未給定引數時的預設行為。

lines

透過執行常規的基於行的差異分析，並彙總移除/新增的行數來計算目錄統計數字。（對於二進位制檔案，計算 64 位元組塊，因為二進位制檔案沒有自然的行的概念）。這是一種比 changes 行為更昂貴的 --dirstat 行為，但它會將檔案內部重新排列的行與其他更改一樣計算在內。結果輸出與您從其他 --*stat 選項獲得的輸出一致。

files

透過計算更改的檔案數量來計算目錄統計數字。每個更改的檔案在目錄統計分析中同等計數。這是計算成本最低的 --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 之一。

--no-color

關閉彩色 diff。它與 --color=never 相同。

--color-moved[=<mode>]

移動的程式碼行會以不同的顏色著色。如果未給出此選項，<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 的移動檢測時如何忽略空白。這些模式可以作為逗號分隔的列表給出：

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

預設情況下，單詞由空白分隔；參見下面的 --word-diff-regex。<mode> 預設為 plain，並且必須是以下之一：

color

僅使用顏色高亮顯示更改的單詞。隱含 --color。

plain

顯示單詞為 [-已刪除-] 和 {已新增}。如果分隔符出現在輸入中，則不嘗試轉義，因此輸出可能會模糊不清。

porcelain

使用一種特殊的基於行的格式，旨在供指令碼消費。新增/刪除/未更改的執行以通常的統一差異格式列印，行首以 +/-/` ` 字元開頭，並延伸到行尾。輸入中的換行符由其單獨一行上的波浪號 ~ 表示。

none

再次停用單詞 diff。

請注意，儘管第一個模式的名稱如此，如果啟用，所有模式都使用顏色高亮顯示更改的部分。

--word-diff-regex=<regex>

使用 <regex> 來決定什麼是單詞，而不是將非空白字元的連續序列視為一個單詞。除非已啟用，否則這也隱含 --word-diff。

<regex> 的每個不重疊匹配都被視為一個單詞。這些匹配之間的任何內容都被視為空白並被忽略（！）以查詢差異。您可能希望在正則表示式後附加 |[^[:space:]] 以確保它匹配所有非空白字元。包含換行符的匹配會在換行符處被靜默截斷（！）。

例如，--word-diff-regex=. 會將每個字元視為一個單詞，並相應地逐字元顯示差異。

正則表示式也可以透過差異驅動程式或配置選項設定，詳見 gitattributes[5] 或 git-config[1]。顯式給出它會覆蓋任何差異驅動程式或配置設定。差異驅動程式會覆蓋配置設定。

--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> 中全域性模式的順序決定。所有路徑名匹配第一個模式的檔案首先輸出，所有路徑名匹配第二個模式（但不匹配第一個）的檔案接下來輸出，依此類推。所有路徑名不匹配任何模式的檔案最後輸出，如同檔案末尾有一個隱式的全匹配模式一樣。如果多個路徑名具有相同的排名（它們匹配相同的模式但沒有更早的模式），則它們相對於彼此的輸出順序是正常的順序。

<orderfile> 解析如下：

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

  • 以井號（"#"）開頭的行被忽略，因此它們可以用作註釋。如果模式以井號開頭，請在模式開頭新增反斜槓（"\"）。

  • 其他每行包含一個模式。

模式具有與 fnmatch(3) 不帶 FNM_PATHNAME 標誌時使用的模式相同的語法和語義，但如果刪除任意數量的最終路徑名元件後仍匹配模式，則路徑名也匹配該模式。例如，模式 "foo*bar" 匹配 "fooasdfbar" 和 "foo/bar/baz/asdf" 但不匹配 "foobarx"。

--skip-to=<file>
--rotate-to=<file>

從輸出中丟棄命名 <file> 之前的檔案（即 skip to），或將其移動到輸出末尾（即 rotate to）。這些選項主要是為 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]。由於文字轉換過濾器通常是單向轉換，因此生成的差異適合人工閱讀，但無法應用。因此，文字轉換過濾器預設僅對 git-diff[1] 和 git-log[1] 啟用，但不對 git-format-patch[1] 或差異底層命令啟用。

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

分別與“base”版本、“我們分支”或“他們分支”進行差異比較。使用這些選項時，不顯示合併條目的差異。

預設是與我們的分支（-2）和已乾淨解決的路徑進行差異比較。可以給出選項 -0 以省略未合併條目的差異輸出，只顯示“未合併”。

-c
--cc

這會比較階段 2（我們的分支）、階段 3（他們的分支）和工作區檔案，並輸出合併差異，類似於 diff-tree 使用這些標誌顯示合併提交的方式。

-q

即使檔案不存在也保持靜默

原始輸出格式

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：“未知”更改型別（很可能是一個 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 選項，為合併提交也生成差異輸出。輸出與上述格式的不同之處如下：

  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

請注意，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 格式略有不同：

  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>

    檔案模式 <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-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);

  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> 的差異配合使用，不用於組合差異格式。

  3. 後面跟著一個兩行的“原始檔/目標檔案”頭：

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

    類似於傳統 unified diff 格式的兩行頭，/dev/null 用於指示已建立或已刪除的檔案。

    然而，如果提供了 --combined-all-paths 選項，您將得到一個 N+1 行的“原始檔/目標檔案”頭，而不是兩行的“原始檔/目標檔案”頭，其中 N 是合併提交中父級的數量：

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

    如果重新命名或複製檢測處於活動狀態，這種擴充套件格式會很有用，可以讓您檢視不同父級中檔案的原始名稱。

  4. 塊頭格式已修改，以防止人們意外地將其饋送給 patch -p1。組合差異格式是為審查合併提交更改而建立的，並非用於應用。該更改類似於擴充套件 索引 頭中的更改：

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

    組合 diff 格式的塊頭中有（父級數量 + 1）個 @ 字元。

與傳統的 統一 差異格式不同，後者顯示兩個檔案 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，又稱“我們的版本”，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

即從左到右：

  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