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

名稱

git-diff-index - 比較樹與工作區或索引

概要

git diff-index [-m] [--cached] [--merge-base] [<common-diff-options>] <tree-ish> [<path>…​]

描述

將樹物件中找到的 blob 的內容和模式與工作區中相應的已跟蹤檔案或索引中相應的路徑進行比較。如果存在 <path> 引數,則只比較與這些模式匹配的路徑。否則,比較所有已跟蹤檔案。

選項

-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

以原始格式生成 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>]]]

生成 diffstat。預設情況下,檔名部分將使用盡可能多的空間,其餘空間用於圖表部分。最大寬度預設為終端寬度,如果未連線到終端則為 80 列,並且可以透過 <width> 覆蓋。檔名部分的寬度可以透過在逗號後給定另一個寬度 <name-width> 或透過設定 diff.statNameWidth=<name-width> 來限制。圖表部分的寬度可以透過使用 --stat-graph-width=<graph-width> 或透過設定 diff.statGraphWidth=<graph-width> 來限制。使用 --stat--stat-graph-width 會影響所有生成 stat 圖表的命令,而設定 diff.statNameWidthdiff.statGraphWidth 不會影響 git format-patch。透過給定第三個引數 <count>,可以將輸出限制為前 <count> 行,如果還有更多行,則後面跟 ...

這些引數也可以使用 --stat-width=<width>--stat-name-width=<name-width>--stat-count=<count> 單獨設定。

--compact-summary

在 diffstat 中輸出擴充套件頭資訊的精簡摘要,例如檔案建立或刪除(“new”或“gone”,如果是符號連結則可選 +l)和模式更改(+x-x 分別用於新增或刪除可執行位)。該資訊位於檔名部分和圖表部分之間。隱含 --stat

--numstat

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

--shortstat

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

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

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

changes

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

lines

透過執行常規的基於行的 diff 分析並彙總已刪除/已新增的行數來計算目錄統計數字。(對於二進位制檔案,改為計算 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 的形式顯示提交範圍內子模組內容的更改。如果配置選項未設定,則預設為 diff.submoduleshort 格式。

--color[=<when>]

顯示彩色 diff。--color(即不帶 =<when>)與 --color=always 相同。<when> 可以是 alwaysneverauto 之一。

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

將單詞顯示為 [-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 的 contextoldnew 行中的空白錯誤。多個值用逗號分隔,none 重置先前的值,default 將列表重置為 newallold,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 之間的 diff。生成的補丁不適用於 patchgit 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> 之間的區別,考慮一個在同一檔案中具有以下 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> 中全域性模式的順序決定。所有路徑名匹配第一個模式的檔案首先輸出,所有路徑名匹配第二個模式(但不匹配第一個)的檔案其次輸出,依此類推。所有路徑名不匹配任何模式的檔案最後輸出,就像檔案末尾有一個隱式匹配所有模式一樣。如果多個路徑名具有相同的等級(它們匹配相同的模式但沒有更早的模式),則它們相對於彼此的輸出順序是正常順序。

<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 生成補丁 hunk 頭的方式相同(參見 gitattributes[5] 中“定義自定義 hunk-header”)。

--exit-code

使程式以類似於 diff(1) 的程式碼退出。也就是說,如果存在差異,則以 1 退出,0 表示無差異。

--quiet

停用程式的所有輸出。隱含 --exit-code。停用外部 diff 助手的執行,其退出程式碼不受信任,即其各自的配置選項 diff.trustExitCodediff.<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 過濾器通常是單向轉換,因此生成的 diff 適合人工閱讀,但無法應用。因此,textconv 過濾器預設僅對 git-diff[1]git-log[1] 啟用,而不對 git-format-patch[1] 或 diff 內部命令啟用。

--ignore-submodules[=(none|untracked|dirty|all)]

在 diff 生成中忽略對子模組的更改。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.noprefixdiff.srcPrefixdiff.dstPrefixdiff.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]

<tree-ish>

要比較的樹物件的 ID。

--cached

根本不考慮磁碟上的檔案。

--merge-base

不直接比較 <tree-ish>,而是使用 <tree-ish> 和 HEAD 之間的合併基礎。<tree-ish> 必須是一個提交。

-m

預設情況下,索引中記錄但未檢出的檔案會報告為已刪除。此標誌使 git diff-index 宣告所有未檢出的檔案都是最新的。

原始輸出格式

git-diff-indexgit-diff-treegit-diff-filesgit 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,請報告)

狀態字母 CR 總是後跟一個分數(表示移動或複製的源和目標之間的相似度百分比)。狀態字母 M 可以後跟一個分數(表示檔案重寫的差異百分比)。

如果檔案系統上的檔案與索引不同步,則“dst”的 SHA1 顯示為全 0。

示例

:100644 100644 5be4a4a 0000000 M file.c

如果沒有 -z 選項,包含“不尋常”字元的路徑名將按照配置變數 core.quotePath 的解釋進行引用(參見 git-config[1])。使用 -z 時,檔名按原樣輸出,行以 NUL 位元組終止。

合併的 diff 格式

git-diff-treegit-diff-filesgit-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

請注意,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_DIFFGIT_DIFF_OPTS 環境變數(參見 git[1])以及 diff 屬性(參見 gitattributes[5])自定義補丁文字的建立。

-p 選項生成的輸出與傳統的 diff 格式略有不同:

  1. 它前面是“git diff”頭,看起來像這樣:

    diff --git a/file1 b/file2

    除非涉及重新命名/複製,否則 a/b/ 檔名是相同的。特別是,即使是建立或刪除,也不會使用 /dev/null 來代替 a/b/ 檔名。

    當涉及重新命名/複製時,file1file2 分別顯示重新命名/複製的原始檔名稱和重新命名/複製生成的檔名稱。

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

任何生成 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> 與其餘模式不同時出現。包含檢測到的內容移動(重新命名和複製檢測)資訊的擴充套件頭旨在與兩個 <tree-ish> 的 diff 一起使用,並且不用於組合 diff 格式。

  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。組合 diff 格式是為了審查合併提交更改而建立的,並非旨在應用。此更改類似於擴充套件 索引 頭中的更改:

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

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

與傳統的 unified 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 是階段 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 將產生路徑名,但如果該 NULNUL,則記錄將顯示兩條路徑。

操作模式

您可以選擇完全信任索引檔案(使用 --cached 標誌)或要求 diff 邏輯將任何與 stat 狀態不匹配的檔案顯示為“暫定更改”。這兩種操作確實都非常有用。

快取模式

如果指定了 --cached,它允許您查詢:

show me the differences between HEAD and the current index
contents (the ones I'd write using 'git write-tree')

例如,假設您在工作目錄中進行了操作,更新了索引中的一些檔案,並準備提交。您想確切地看到您將要提交的內容,而無需寫入新的樹物件並以此方式進行比較。要做到這一點,您只需執行:

git diff-index --cached HEAD

示例:假設我將 commit.c 重新命名為 git-commit.c,並且我已經執行了 update-index 以使其在索引檔案中生效。git diff-files 將完全不顯示任何內容,因為索引檔案與我的工作目錄匹配。但是執行 git diff-index 會顯示:

torvalds@ppc970:~/git> git diff-index --cached HEAD
:100644 000000 4161aecc6700a2eb579e842af0b7f22b98443f74 0000000000000000000000000000000000000000 D	commit.c
:000000 100644 0000000000000000000000000000000000000000 4161aecc6700a2eb579e842af0b7f22b98443f74 A	git-commit.c

您可以輕鬆看出上面是一個重新命名。

事實上,git diff-index --cached 應該始終與實際執行 git write-tree 並進行比較完全等效。除了當您只想檢查當前狀態時,它會更好用。

因此,執行 git diff-index --cached 基本上在您問自己“我已經標記了哪些要提交的內容,以及與之前的樹有什麼區別”時非常有用。

非快取模式

“非快取”模式採取了一種不同的方法,它可能在這兩種模式中更有用,因為它所做的無法透過 git write-tree + git diff-tree 來模擬。因此,它是預設模式。非快取版本提出的問題是:

show me the differences between HEAD and the currently checked out
tree - index contents _and_ files that aren't up to date

這顯然也是一個非常有用的問題,因為它會告訴你你**可以**提交什麼。同樣,輸出與 git diff-tree -r 的輸出完全匹配,但又有所不同。

不同之處在於,如果某個檔案與索引不匹配,我們沒有它的支援儲存物件,我們使用神奇的“全零”SHA1 來表示。所以,假設你已經編輯了 kernel/sched.c,但還沒有對它執行 git update-index —— 新狀態沒有關聯的“物件”,你將得到:

torvalds@ppc970:~/v2.6/linux> git diff-index --abbrev HEAD
:100644 100644 7476bb5ba 000000000 M	kernel/sched.c

即,它顯示樹已更改,並且 kernel/sched.c 未同步,可能包含新內容。全零 SHA1 意味著要獲得真正的差異,你需要直接檢視工作目錄中的物件,而不是執行物件到物件的差異比較。

注意
與此型別的其他命令一樣,git diff-index 根本不檢視檔案的內容。所以,也許 kernel/sched.c 實際上並沒有更改,只是你“碰”了一下它。無論哪種情況,這都表示你需要執行 git update-index 以使索引同步。
注意
你可以看到檔案混合顯示為“已更新”和“工作目錄中仍有未暫存更改”的狀態。你總是可以判斷哪個檔案處於哪種狀態,因為“已更新”的檔案顯示有效的 SHA1,而“與索引不同步”的檔案將始終具有特殊的“全零”SHA1。

GIT

Git[1] 套件的一部分

scroll-to-top