Git

git-diff-tree 最後更新於 2.49.0

名稱

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> 行上下文（而不是通常的三行）的 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.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 分別用於新增或刪除可執行位）在 diffstat 中。資訊放置在檔名部分和圖形部分之間。隱含 --stat。

--numstat

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

--shortstat

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

-X [<param>,...]

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

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

changes: 透過計算從源中刪除或新增到目標中的行數來計算 dirstat 數字。這會忽略檔案內部純程式碼移動的數量。換句話說，檔案中的行重排不像其他更改那樣被計算在內。這是未提供引數時的預設行為。
lines: 透過執行常規的基於行的差異分析並彙總已刪除/已新增的行數來計算 dirstat 數字。（對於二進位制檔案，改為計算 64 位元組塊，因為二進位制檔案沒有自然的行概念）。這是一種比 changes 行為更昂貴的 --dirstat 行為，但它會將檔案內重新排列的行與其他更改一樣計算在內。結果輸出與您從其他 --*stat 選項獲得的輸出一致。
files: 透過計算已更改的檔案數量來計算 dirstat 數字。每個已更改的檔案在 dirstat 分析中權重相等。這是計算成本最低的 --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: 將單詞顯示為 [-removed-] 和 {added}。如果分隔符出現在輸入中，則不嘗試轉義分隔符，因此輸出可能不明確。
porcelain: 使用一種特殊的基於行的格式，旨在供指令碼使用。新增/刪除/未更改的執行以通常的統一差異格式列印，行首以 +/-/` ` 字元開頭，並延伸到行尾。輸入中的換行符由其單獨一行上的波浪號 ~ 表示。
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>

突出顯示差異的 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> 之前的檔案（即跳到），或者將它們移到輸出的末尾（即旋轉到）。這些選項主要用於 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] 中的“定義自定義塊頭”）。

--exit-code

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

--quiet

停用程式的所有輸出。隱含 --exit-code。停用執行外部 diff 輔助工具，其退出程式碼不可信，即它們各自的配置選項 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]。由於 textconv 過濾器通常是單向轉換，因此生成的差異適合人類閱讀，但無法應用。因此，textconv 過濾器預設只為 git-diff[1] 和 git-log[1] 啟用，而不為 git-format-patch[1] 或 diff 內部命令啟用。

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

<tree-ish>: 樹物件的 ID。
<path>…: 如果提供，結果將僅限於與所提供路徑規範之一匹配的檔案子集。
-r: 遞迴進入子樹。
-t: 顯示樹條目本身以及子樹。隱含 -r。
--root: 當指定 --root 時，初始提交將顯示為一個大型建立事件。這等同於與 NULL 樹的差異。
--merge-base: 不直接比較 <tree-ish>s，而是使用兩個 <tree-ish>s 之間的合併基作為“之前”的一方。必須提供兩個 <tree-ish>s，並且它們都必須是提交。
--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 位元組十六進位制提交物件名稱，而是顯示一個唯一標識該物件的字首。可以使用 "--abbrev=<n>" 選項（如果顯示差異輸出，此選項也會對其進行修改）來指定字首的最小長度。

這應該會使使用 80 列終端的人員更容易閱讀 "--pretty=oneline"。
--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]），這些註釋是提交的註解。這是 git log、git show 和 git whatchanged 命令的預設行為，當命令列上沒有給出 --pretty、--format 或 --oneline 選項時。

預設情況下，顯示的註釋來自 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: 即使差異本身為空，也顯示提交本身和提交日誌訊息。

美觀格式 (PRETTY FORMATS)

如果提交是合併提交，並且美觀格式不是 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 指向某個分支，則在 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 選項的規則。@ 之前的部分是命令列上給出的 refname（所以 git log -g refs/heads/master 將產生 refs/heads/master@{0}）。

%gd

縮短的 reflog 選擇器；與 %gD 相同，但 refname 部分為人機可讀性而縮短（因此 refs/heads/master 變為 master）。

%gn

引用日誌身份名稱

%gN

引用日誌身份名稱（遵循 .mailmap，參見 git-shortlog[1] 或 git-blame[1]）

%ge

引用日誌身份電子郵件

%gE

引用日誌身份電子郵件（遵循 .mailmap，參見 git-shortlog[1] 或 git-blame[1]）

%gs

引用日誌主題

%(trailers[:<options>])
顯示由 git-interpret-trailers[1] 解釋的正文尾部。後跟冒號和零個或多個逗號分隔的選項。如果任何選項提供了多次，則以最後一次出現為準。
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`）。如果命令列上尚未提供 `--decorate`，`%d` 和 `%D` 佔位符將使用“short”修飾格式。

布林選項接受可選值 [=<bool-value>]。--type=bool git-config[1] 接受的所有值，如 yes 和 off，都受支援。不帶 =<value> 提供布林選項等同於帶 =true 提供。

如果在佔位符的 % 之後新增 +（加號），則僅當佔位符展開為非空字串時，才會在展開之前立即插入一個換行符。

如果在佔位符的 % 之後新增 -（減號），則僅當佔位符展開為空字串時，才會刪除緊接在展開之前的所有連續換行符。

如果在佔位符的 % 之後新增 ` `（空格），則僅當佔位符展開為非空字串時，才會在展開之前立即插入一個空格。

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

即從左到右：

一個冒號。
"src" 的模式；如果為建立或未合併，則為 000000。
一個空格。
"dst" 的模式；如果為刪除或未合併，則為 000000。
一個空格。
"src" 的 SHA1；如果為建立或未合併，則為 0{40}。
一個空格。
"dst" 的 SHA1；如果為刪除、未合併或“工作區與索引不同步”，則為 0{40}。
一個空格。
狀態，後跟可選的“分數”數字。
當使用 -z 選項時，一個製表符或一個 NUL。
"src" 的路徑。
當使用 -z 選項時，一個製表符或一個 NUL；僅在 C 或 R 狀態下存在。
"dst" 的路徑；僅在 C 或 R 狀態下存在。
當使用 -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 選項，以便也為合併提交生成差異輸出。輸出與上面描述的格式不同，具體如下：

每個父級都有一個冒號
有更多的“src”模式和“src”SHA1
狀態是每個父級的狀態字元的連線
沒有可選的“分數”數字
以製表符分隔的檔案路徑名

對於 -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 格式略有不同：

它前面是“git diff”頭，看起來像這樣：
```
diff --git a/file1 b/file2
```
a/ 和 b/ 檔名通常相同，除非涉及重新命名/複製操作。特別地，即使是建立或刪除，也不會使用 /dev/null 來代替 a/ 或 b/ 檔名。

當涉及重新命名/複製時，file1 和 file2 分別顯示重新命名/複製的原始檔名稱和重新命名/複製生成的檔名稱。
後面跟著一個或多個擴充套件頭行：
```
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>；否則，單獨的行指示舊模式和新模式。
包含“不尋常”字元的路徑名將按照配置變數 core.quotePath 的解釋進行引用（參見 git-config[1]）。
輸出中的所有 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
```
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);

它前面是“git diff”頭，看起來像這樣（使用 -c 選項時）：
```
diff --combined file
```
或者像這樣（使用 --cc 選項時）：
```
diff --cc file
```
後面跟著一個或多個擴充套件頭行（此示例顯示了一個包含兩個父級的合併）：
```
index <hash>,<hash>..<hash>
mode <mode>,<mode>..<mode>
new file mode <mode>
deleted file mode <mode>,<mode>
```
mode <mode>,<mode>..<mode> 行僅在至少一個 <mode> 與其餘的不同時才會出現。帶有檢測到的內容移動（重新命名和複製檢測）資訊的擴充套件頭部旨在與兩個<tree-ish> 的差異配合使用，並且不用於合併差異格式。
後面跟著一個兩行的“原始檔/目標檔案”頭：
```
--- a/file
+++ b/file
```
類似於傳統 unified diff 格式的兩行頭，/dev/null 用於指示已建立或已刪除的檔案。

然而，如果提供了 --combined-all-paths 選項，您將得到一個 N+1 行的“原始檔/目標檔案”頭，而不是兩行的“原始檔/目標檔案”頭，其中 N 是合併提交中父級的數量：
```
--- a/file
--- a/file
--- a/file
+++ b/file
```
如果重新命名或複製檢測處於活動狀態，這種擴充套件格式會很有用，可以讓您檢視不同父級中檔案的原始名稱。
塊頭格式已被修改，以防止人們意外地將其提供給 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

即從左到右：

新增的行數；
一個製表符；
刪除的行數；
一個製表符；
路徑名（可能包含重新命名/複製資訊）；
一個換行符。

當 -z 輸出選項生效時，輸出格式如下：

1	2	README NUL
3	1	NUL arch/i386/Makefile NUL arch/x86/Makefile NUL

即：

新增的行數；
一個製表符；
刪除的行數；
一個製表符；
一個 NUL（僅在重新命名/複製時存在）；
原始映像中的路徑名；
一個 NUL（僅在重新命名/複製時存在）；
後映像中的路徑名（僅在重新命名/複製時存在）；
一個 NUL。

在重新命名情況下，預映像路徑之前的額外 NUL 是為了讓讀取輸出的指令碼能夠判斷當前讀取的記錄是單路徑記錄還是重新命名/複製記錄，而無需提前讀取。在讀取新增和刪除的行之後，讀取到 NUL 會得到路徑名，但如果那是 NUL，則記錄將顯示兩個路徑。

Git[1] 套件的一部分

設定和配置

獲取和建立專案

基本快照

分支與合併

共享和更新專案

檢查和比較

打補丁

除錯

電子郵件

外部系統

伺服器管理

指南

管理

底層命令

名稱

概要

描述

選項