要顯示的物件名稱（預設為 HEAD）。關於物件名稱表示方式的更完整列表，請參閱 gitrevisions[7] 中的「指定修訂版本 (SPECIFYING REVISIONS)」章節。

以指定格式美化列印提交日誌的內容，其中 <format> 可以是 oneline、short、medium、full、fuller、reference、email、raw、format:<string> 和 tformat:<string> 之一。當 <format> 不是上述任何一種，且其中包含 %<placeholder> 時，它的行為就像給定了 --pretty=tformat:<format> 一樣。

不顯示完整的 40 位元組十六進位提交物件名稱，而是顯示唯一命名物件的前綴。--abbrev=<n>（如果顯示，它也會修改差異輸出）選項可用於指定前綴的最小長度。

顯示完整的 40 位元組十六進位提交物件名稱。這會抵消 --abbrev-commit，無論是顯式的還是由 --oneline 等其他選項隱含的。它還會覆蓋 log.abbrevCommit 變數。

這是 --pretty=oneline --abbrev-commit 同時使用的簡寫。

提交物件在其編碼標頭中記錄用於日誌訊息的字元編碼；此選項可用於告訴指令以使用者偏好的編碼重新編碼提交日誌訊息。對於非底層指令，預設為 UTF-8。請注意，如果物件聲稱以 X 編碼且我們正在以 X 輸出，我們將原樣輸出該物件；這意味著原始提交中的無效序列可能會被複製到輸出中。同樣地，如果 iconv(3) 無法轉換提交，我們將靜默地原樣輸出原始物件。

在顯示之前，在日誌訊息中執行製表符擴展（將每個製表符替換為足夠的空格，以填滿至下一個顯示欄位，該欄位是 <n> 的倍數）。--expand-tabs 是 --expand-tabs=8 的簡寫，而 --no-expand-tabs 是 --expand-tabs=0 的簡寫，後者會停用製表符擴展。

顯示提交日誌訊息時，同時顯示註解提交的附註（參見 git-notes[1]）。當指令列中沒有給定 --pretty、--format 或 --oneline 選項時，這是 git log、git show 和 git whatchanged 指令的預設行為。

不顯示附註。這會透過重設顯示附註的引用清單來抵消上述 --notes 選項。選項按指令列上給出的順序解析，因此例如 "--notes --notes=foo --no-notes --notes=bar" 將僅顯示來自 refs/notes/bar 的附註。

除非給出了顯示特定附註的選項，否則顯示預設附註。

這些選項已棄用。請改用上述 --notes/--no-notes 選項。

透過將簽名傳遞給 gpg --verify 來檢查已簽名提交物件的有效性，並顯示輸出。

與 email 類似，但提交訊息中以 "From " 開頭的行（前面有零個或多個 ">"）會用 ">" 括起來，以免被誤認為是新提交的開始。

raw 格式顯示提交物件中完全相同的整個提交。值得注意的是，無論是否使用 --abbrev 或 --no-abbrev，雜湊值都會完整顯示，且「父提交 (parents)」資訊顯示真實的父提交，不考慮嫁接 (grafts) 或歷史簡化。請注意，此格式會影響提交的顯示方式，但不會影響差異 (diff) 的顯示方式（例如使用 git log --raw）。若要在原始差異格式中獲取完整物件名稱，請使用 --no-abbrev。

format:<格式字串> 格式允許您指定想要顯示的資訊。它的工作方式有點像 printf 格式，但顯著的例外是您使用 %n 而不是 \n 來換行。

The author of fe6e0ee was Junio C Hamano, 23 hours ago
The title was >>t4119: test autocomputing -p<n> for traditional diff input.<<

tformat: 格式的工作原理與 format: 完全相同，不同之處在於它提供「結束符 (terminator)」語義而非「分隔符 (separator)」語義。換句話說，每個提交都會附加訊息結束字元（通常是換行符），而不是在項目之間放置分隔符。這意味著單行格式的最後一項將像 "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

$ git log -2 --pretty=tformat:%h 4da45bef
$ git log -2 --pretty=%h 4da45bef

產生修補檔（請參見 使用 -p 產生修補檔文字）。

隱藏差異機制的所有輸出。對於像 git show 這樣預設顯示修補檔的指令，可以用來壓制其輸出，或者取消指令列中先前在別名中定義的 --patch、--stat 等選項的效果。

以預設格式顯示合併提交的差異。這類似於 --diff-merges=on，不同之處在於除非同時給定 -p，否則 -m 不會產生任何輸出。

為合併提交產生組合差異輸出。是 --diff-merges=combined -p 的捷徑。

為合併提交產生稠密組合差異輸出。是 --diff-merges=dense-combined -p 的捷徑。

針對合併提交和一般提交，產生相對於第一個父提交的差異。是 --diff-merges=first-parent -p 的捷徑。

為合併提交產生重新合併的差異輸出。是 --diff-merges=remerge -p 的捷徑。

--diff-merges=off 的同義詞。

指定用於合併提交的差異格式。預設為 `dense-combined`，除非使用了 --first-parent，在這種情況下預設值為 first-parent。

使組合差異（用於合併提交）列出來自所有父提交的檔案名稱。因此，僅在使用了 --diff-merges=[dense-]combined 時有效，且僅在偵測到檔名變更（即已請求偵測重新命名或複製時）時才可能有用。

產生具有 <n> 行上下文的差異。上下文行數預設為 diff.context，如果未設定該組態變數則預設為 3。（由於歷史因素，不帶 <n> 的 -U 會被默認為 -p 的別名）。隱含 --patch。

輸出到指定檔案而非標準輸出 (stdout)。

指定在產生的修補檔中，用於指示新行、舊行或上下文行的字元。通常分別為 +、- 和 ' '。

對於每個提交，使用原始差異格式顯示變更摘要。請參閱 git-diff[1] 的「原始輸出格式 (RAW OUTPUT FORMAT)」章節。這與以原始格式顯示日誌本身不同（後者可透過 --format=raw 達成）。

-p --raw 的別名。

在差異輸出中顯示樹狀物件。

啟用偏移差異區塊 (hunk) 邊界的啟發式演算法，使修補檔更易於閱讀。這是預設值。

停用縮排啟發式演算法。

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

使用 "patience diff" 演算法產生差異。

使用 "histogram diff" 演算法產生差異。

使用 "anchored diff" 演算法產生差異。

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

產生 diffstat。預設情況下，檔名部分將盡可能使用所需的空間，其餘部分用於圖表部分。最大寬度預設為終端寬度，如果未連接到終端，則為 80 個字元，並可由 <寬度> 覆蓋。檔名部分的寬度可以透過在逗號後提供另一個寬度 <名稱寬度> 或透過設定 diff.statNameWidth=<名稱寬度> 來限制。圖表部分的寬度可以透過使用 --stat-graph-width=<圖表寬度> 或透過設定 diff.statGraphWidth=<圖表寬度> 來限制。使用 --stat 或 --stat-graph-width 會影響所有產生統計圖表的指令，而設定 diff.statNameWidth 或 diff.statGraphWidth 不會影響 git format-patch。透過提供第三個參數 <計數>，您可以將輸出限制為前 <計數> 行，如果還有更多行，則後面跟著 ...。

在 diffstat 中輸出擴展標頭資訊的簡要摘要，例如檔案建立或刪除（"new" 或 "gone"，如果是符號連結則可選擇 +l）和模式更改（分別使用 +x 或 -x 表示新增或移除可執行位元）。資訊放在檔案名稱部分和圖形部分之間。隱含 --stat。

類似於 --stat，但以十進位表示法顯示新增和刪除的行數，並顯示不含縮寫的路徑名稱，使其對機器更友善。對於二進位檔案，輸出兩個 - 而非顯示 0 0。

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

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

--dirstat=cumulative 的別名。

--dirstat=files,<param>,... 的別名。

輸出擴展標頭資訊的簡要摘要，例如建立、重新命名和模式更改。

-p --stat 的別名。

使用 NUL 而非換行符來分隔提交。

僅顯示後映像 (post-image) 樹中每個更改檔案的名稱。檔案名稱通常以 UTF-8 編碼。更多資訊請參見 git-log[1] 手冊頁中有關編碼的討論。

僅顯示每個更改檔案的名稱和狀態。有關狀態字母的含義，請參閱 --diff-filter 選項的說明。與 --name-only 一樣，檔案名稱通常以 UTF-8 編碼。

指定如何顯示子模組中的差異。當指定 --submodule=short 時，使用 short 格式。此格式僅顯示範圍開頭和結尾的提交名稱。當指定 --submodule 或 --submodule=log 時，使用 log 格式。此格式列出範圍內的提交，如同 git-submodule[1] 的 summary 所做的那樣。當指定 --submodule=diff 時，使用 diff 格式。此格式顯示提交範圍之間子模組內容變更的內聯差異。預設為 diff.submodule，如果未設定該配置選項，則為 short 格式。

顯示有顏色的差異。--color（即不含 =<when>）與 --color=always 相同。<when> 可以是 always、never 或 auto 之一。

關閉彩色差異。這與 --color=never 相同。

移動的程式碼行會以不同的顏色顯示。如果不提供該選項，<mode> 預設為 no；如果提供不帶模式的選項，則預設為 zebra。模式必須是下列之一：

關閉移動偵測。這可用於覆蓋組態設定。這與 --color-moved=no 相同。

這配置了執行 --color-moved 的移動偵測時如何忽略空白。這些模式可以作為逗號分隔的清單提供：

執行移動偵測時不要忽略空白。這可用於覆蓋組態設定。這與 --color-moved-ws=no 相同。

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

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

相當於 --word-diff=color 加上（如果指定了正規表示式）--word-diff-regex=<regex>。

關閉重新命名偵測，即使配置檔案預設為開啟。

是否使用空白內容物件作為重新命名來源。

如果變更引入了衝突標記或空白錯誤，則發出警告。什麼被視為空白錯誤由 core.whitespace 配置控制。預設情況下，尾隨空白（包括僅由空白組成的行）和在行初始縮排內緊隨製表符 (tab) 之後的空格字元被視為空白錯誤。如果發現問題，則以非零狀態碼退出。與 --exit-code 不相容。

在差異的 context、old 或 new 行中突出顯示空白錯誤。多個值由逗號分隔，none 重設先前的值，default 將清單重設為 new，而 all 是 old,new,context 的簡寫。當未提供此選項，且配置變數 diff.wsErrorHighlight 未設定時，僅突出顯示 new 行中的空白錯誤。空白錯誤使用 color.diff.whitespace 著色。

在產生修補檔格式輸出時，在 "index" 行顯示完整的前映像和後映像內容物件名稱，而非僅顯示前幾個字元。

除了 --full-index 之外，還產生一個可以使用 git-apply 套用的二進位差異。隱含 --patch。

在 diff-raw 格式輸出和 diff-tree 標頭行中，不顯示完整的 40 位元組十六進位物件名稱，而是顯示唯一引用該物件的長度至少為 <n> 個十六進位位元的縮寫。在 diff-patch 輸出格式中，--full-index 優先權較高，即如果指定了 --full-index，則無論是否指定 --abbrev，都會顯示完整的內容物件名稱。非預設的位元數可以使用 --abbrev=<n> 指定。

將完全重寫的變更拆分為刪除和建立對。這有兩個目的：

如果正在產生差異，則為每個提交偵測並報告重新命名。關於在遍歷歷史時追蹤跨越重新命名的檔案，請參閱 --follow。如果指定了 <n>，它是相似度索引的閾值（即相對於檔案大小的新增/刪除量）。例如，-M90% 表示如果檔案變更不到 10%，Git 應將刪除/新增對視為重新命名。若沒有 % 符號，該數字會被視為分數，前面帶有小數點。即 -M5 變成 0.5，因此與 -M50% 相同。同樣地，-M05 與 -M5% 相同。要將偵測限制為精確的重新命名，請使用 -M100%。預設的相似度索引為 50%。

偵測複製以及重新命名。另請參見 --find-copies-harder。如果指定了 <n>，其含義與 -M<n> 相同。

出於效能原因，預設情況下，僅當複製的原始檔案在同一個變更集中被修改時，-C 選項才會尋找複製。此旗標使指令檢查未修改的檔案作為複製來源的候選者。對於大型專案來說，這是一項非常耗資源的操作，請謹慎使用。提供多個 -C 選項具有相同的效果。

省略刪除的前映像，即僅列印標頭，而不列印前映像與 /dev/null 之間的差異。產生的修補檔不打算使用 patch 或 git apply 套用；這僅適用於只想專注於檢閱變更後文字的人員。此外，輸出顯然缺乏足夠的資訊來反向套用此類修補檔，即使是手動套用也是如此，這就是該選項名稱的由來。

-M 和 -C 選項涉及一些初步步驟，可以廉價地偵測重新命名/複製的子集，然後是一個詳盡的後備部分，將所有剩餘的未配對目的地與所有相關來源進行比較。（對於重新命名，僅剩餘的未配對來源是相關的；對於複製，所有原始來源都是相關的。）對於 N 個來源和目的地，此詳盡檢查的複雜度為 O(N^2)。如果涉及的來源/目的地檔案數量超過指定數量，此選項可防止執行重新命名/複製偵測的詳盡部分。預設為 diff.renameLimit。請注意，值 0 被視為無限制。

僅選擇已新增 (A)、已複製 (C)、已刪除 (D)、已修改 (M)、已重新命名 (R)、類型（即一般檔案、符號連結、子模組等）已變更 (T)、未合併 (U)、未知 (X) 或配對已斷開 (B) 的檔案。可以使用過濾字元的任何組合（包括無）。當組合中加入 * (全選或不選) 時，如果比較中有任何檔案符合其他標準，則選擇所有路徑；如果沒有檔案符合其他標準，則不選擇任何內容。

尋找更改檔案中指定 <string> 出現次數（即新增/刪除）的差異。供腳本編寫者使用。

尋找修補檔文字中包含符合 <regex> 的新增/移除行的差異。

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

尋找更改指定物件出現次數的差異。類似於 -S，只是參數不同，它不是搜尋特定字串，而是搜尋特定的物件識別碼 (ID)。

當 -S 或 -G 找到變更時，顯示該變更集中的所有變更，而不僅僅是包含 <string> 變更的檔案。

將提供給 -S 的 <string> 視為擴展的 POSIX 正規表示式進行匹配。

控制檔案在輸出中顯示的順序。這會覆蓋 diff.orderFile 配置變數（參見 git-config[1]）。要取消 diff.orderFile，請使用 -O/dev/null。

從輸出中丟棄指定 <file> 之前的檔案（即 跳至 (skip to)），或將它們移動到輸出的末尾（即 旋轉至 (rotate to)）。這些選項主要是為了 git difftool 指令發明的，在其他情況下可能不太有用。

交換兩個輸入；也就是說，顯示從索引或磁碟檔案到樹內容的差異。

當從專案的子目錄執行時，可以使用此選項告訴它排除該目錄之外的更改，並顯示相對於該目錄的路徑名稱。當您不在子目錄中（例如在赤裸儲存庫中）時，可以透過提供 <path> 作為參數來命名使輸出相對於哪個子目錄。--no-relative 可用於抵消 diff.relative 配置選項和先前的 --relative。

將所有檔案視為文字。

進行比較時忽略行尾的回車符 (carriage-return)。

忽略行尾 (EOL) 的空白變更。

忽略空白數量的變更。這會忽略行尾的空白，並將所有其他一個或多個空白字元的序列視為等效。

比較行時忽略空白。即使一行有空白而另一行沒有，這也會忽略差異。

忽略行全是空白的變更。

忽略所有行均符合 <regex> 的變更。此選項可以指定多次。

顯示差異修改塊之間的內容，最多到指定的 <n> 行，從而融合彼此接近的修改塊。預設為 diff.interHunkContext，如果未設定配置選項則為 0。

顯示整個函式作為每次變更的上下文行。函式名稱的確定方式與 git diff 算出修補檔區塊標頭的方式相同（參見 gitattributes[5] 中的「定義自訂區塊標頭」）。

允許執行外部差異輔助程式。如果您使用 gitattributes[5] 設定了外部差異驅動程式，則需要將此選項與 git-log[1] 及其相關指令一起使用。

禁止外部差異驅動程式。

比較二進位檔案時允許（或禁止）執行外部文字轉換過濾器。詳細資訊請參見 gitattributes[5]。由於文字轉換過濾器通常是單向轉換，因此產生的差異適合人類閱讀，但無法套用。出於這個原因，文字轉換過濾器預設僅對 git-diff[1] 和 git-log[1] 啟用，而不對 git-format-patch[1] 或差異底層 (plumbing) 指令啟用。

在差異產生中忽略子模組的變更。all 是預設值。使用 none 會將包含未追蹤或已修改檔案的子模組視為已修改，或者當其 HEAD 與超級專案中記錄的提交不同時，也可用於覆蓋 git-config[1] 或 gitmodules[5] 中 ignore 選項的任何設定。當使用 untracked 時，如果子模組僅包含未追蹤的內容，則不會將其視為髒污（但仍會掃描其是否包含已修改的內容）。使用 dirty 會忽略對子模組工作樹的所有變更，僅顯示對儲存在超級專案中的提交的變更（這是 1.7.0 之前的行為）。使用 all 會隱藏對子模組的所有變更。

顯示指定的來源 <prefix> 而非 "a/"。

顯示指定的目的地 <prefix> 而非 "b/"。

不顯示任何來源或目的地前綴。

使用預設的來源和目的地前綴（"a/" 和 "b/"）。這會覆蓋配置變數，例如 diff.noprefix、diff.srcPrefix、diff.dstPrefix 和 diff.mnemonicPrefix（參見 git-config[1]）。

在輸出的每一行前面附加一個額外的 <prefix>。

預設情況下，由 git add -N 新增的項目在 git diff 中顯示為現有的空檔案，在 git diff --cached 中顯示為新檔案。此選項使該項目在 git diff 中顯示為新檔案，在 git diff --cached 中顯示為不存在。可以使用 --ita-visible-in-index 還原此選項。這兩個選項都是實驗性的，將來可能會被移除。

對於指令列上提供的每個路徑規格 (pathspec)，最多下降 <depth> 層目錄。值為 -1 表示無限制。不能與路徑規格中的通配符結合使用。給定一個包含 foo/bar/baz 的樹，下列清單顯示了每組選項產生的匹配項：

顯示標籤 v1.0.0，以及該標籤所指向的物件。

顯示標籤 v1.0.0 所指向的樹狀結構。

顯示標籤 v1.0.0 所指向提交的主旨。

顯示分支 next 倒數第 10 次提交時，檔案 Documentation/README 的內容。

將分支 master 開頭的上述 Makefile 內容連接起來顯示。