在重新命名後繼續列出檔案的歷史紀錄（僅適用於單一檔案）。

列印所顯示任何提交的參照名稱。可用的值為

對於每個候選參照，如果它符合傳遞給 --decorate-refs-exclude 的任何 <pattern> 參數，或者如果它不符合傳遞給 --decorate-refs 的任何 <pattern> 參數，則不要將其用於修飾。配置選項 log.excludeDecoration 允許從修飾中排除參照，但明確的 --decorate-refs 模式將覆蓋 log.excludeDecoration 中的匹配項。

當指定此選項時，它會清除所有先前的 --decorate-refs 或 --decorate-refs-exclude 選項，並放寬預設修飾篩選器以包含所有參照。如果設定檔值 log.initialDecorationSet 被設定為 all，則預設採用此選項。

列印命令列中給出且到達每個提交的參照名稱。

使用 mailmap 檔案將作者和提交者的姓名及電子郵件地址對應到規範的真實姓名和電子郵件地址。請參閱 git-shortlog[1]。

若沒有此旗標，git log -p <path>... 會顯示觸及指定路徑的提交，以及關於這些指定路徑的差異。加上此參數後，將會顯示觸及指定路徑的提交的完整差異；這意味著「<path>...」僅限制提交，而不限制這些提交的差異。

在每個提交的輸出中包含一行 log size <number>，其中 <number> 是該提交訊息的位元組長度。旨在透過允許提前分配空間來加速從 git log 輸出讀取日誌訊息的工具。

追蹤由 <start>,<end> 給出的行範圍，或由 <file> 內的函式名稱正規表示式 <funcname> 給出的演變過程。您不得提供任何路徑規格限制器。這目前僅限於從單一修訂版本開始的遍歷，即您只能提供零個或一個正向修訂版本參數，且 <start> 和 <end>（或 <funcname>）必須存在於起始修訂版本中。您可以多次指定此選項。隱含 --patch。可以使用 --no-patch 抑制修補程式輸出。支援非修補程式差異格式 --raw、--name-only、--name-status 和 --summary。差異統計格式（--stat、--numstat、--shortstat、--dirstat）目前尚未實作。

僅顯示指定修訂範圍內的提交。當未指定 <revision-range> 時，預設為 HEAD（即導致當前提交的整個歷史紀錄）。origin..HEAD 指定所有從當前提交（即 HEAD）可到達，但從 origin 不可到達的提交。如需拼寫 <revision-range> 的完整方法列表，請參閱 gitrevisions[7] 的「指定範圍」(Specifying Ranges) 一節。

僅顯示足以解釋符合指定路徑的檔案如何產生的提交。詳細資訊和其他簡化模式請參閱下文的「歷史簡化」(History Simplification)。

與 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 的同義詞。

指定用於合併提交的差異格式。除非使用 --first-parent，否則預設為 `off`，在這種情況下 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> 指定。

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

若要產生差異（diffs），請為每個提交偵測並報告重新命名。若要在走訪歷史記錄時追蹤檔案重新命名，請參閱 --follow。若指定了 <n>，則它是相似度索引的閾值（即相較於檔案大小的新增/刪除量）。例如，-M90% 表示若檔案有超過 90% 的內容未變更，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 的樹，下列清單顯示了每組選項產生的匹配項：

顯示完整的提交歷史，但跳過任何合併（merges）。

顯示自 v2.6.12 版本以來，所有變更過 include/scsi 或 drivers/scsi 子目錄中任何檔案的提交。

顯示過去兩週內對 gitk 檔案的變更。-- 是必要的，以避免與名為 gitk 的分支混淆。

顯示位於「test」分支但尚未合併至「release」分支的提交，並列出每個提交所修改的路徑。

顯示變更 builtin/rev-list.c 的提交，包括在檔案重新命名為現有名稱之前的那些提交。

顯示所有位於任何本地分支，但不在 origin 的任何遠端追蹤分支中的提交（即您擁有但 origin 沒有的提交）。

顯示所有位於本地 master 分支，但不在任何遠端儲存庫 master 分支中的提交。

顯示歷史記錄包含變更差異，但僅從「主分支」觀點出發，跳過來自合併分支的提交，並顯示合併所引入的完整差異。這僅在嚴格執行將所有主題分支合併到單一整合分支的原則時才有意義。

顯示檔案 main.c 中的 main() 函式如何隨時間演進。

將顯示的提交數量限制為 3 個。

--format 選項的預設值。（參閱上述的漂亮的格式。）預設為 medium。

顯示記錄時使用的編碼。（參閱上述的討論。）若有設定，則預設為 i18n.commitEncoding 的值，否則為 UTF-8。

若為 true，則使 git-log[1]、git-show[1] 和 git-whatchanged[1] 預設使用 --abbrev-commit。您可以使用 --no-abbrev-commit 來覆寫此選項。

為 log 指令設定預設的日期時間模式。設定 log.date 的值類似於使用 git log 的 --date 選項。詳細資訊請參閱 git-log[1]。

列出 log 指令所顯示的任何提交的參考名稱。可能的值為

預設情況下，git log 僅顯示特定已知參考命名空間的修飾。若指定了 all，則顯示所有參考作為修飾。

從記錄修飾中排除指定的模式。這類似於命令列選項 --decorate-refs-exclude，但此設定選項可被 --decorate-refs 選項覆寫。

設定指定 --diff-merges=on 時使用的差異格式，詳細資訊請參閱 git-log[1] 中的 --diff-merges。預設為 separate。

若為 true，當僅給定單一 <path> 時，git log 的行為就像使用了 --follow 選項一樣。這具有與 --follow 相同的限制，即無法用來追蹤多個檔案，且在非線性歷史中運作不佳。

以逗號分隔的顏色列表，可用於繪製 git log --graph 中的歷史線條。

若為 true，初始提交將顯示為一個大型建立事件。這等同於與空樹狀結構的差異。通常會隱藏根提交的工具（如 git-log[1] 或 git-whatchanged[1]）現在將會顯示它。預設為 True。

若為 true，使 git-log[1]、git-show[1] 和 git-whatchanged[1] 預設使用 --show-signature。

若為 true，使 git-log[1]、git-show[1] 和 git-whatchanged[1] 預設使用 --use-mailmap，否則預設使用 --no-use-mailmap。預設為 True。

解決註記 (notes) 衝突時預設選擇的合併策略。必須是 manual、ours、theirs、union 或 cat_sort_uniq 其中之一。預設為 manual。有關各個策略的更多資訊，請參閱 git-notes[1] 的 "NOTES MERGE STRATEGIES" 章節。

執行合併註記至 refs/notes/<name> 時選擇的合併策略。這會覆寫更一般的 notes.mergeStrategy。有關可用策略的更多資訊，請參閱 git-notes[1] 中的 "NOTES MERGE STRATEGIES" 章節。

使用 git log 系列命令顯示提交訊息時，除了 core.notesRef 或 GIT_NOTES_REF 設定的預設值外，還要從哪個（或哪些，如果是 glob 或指定多次）參照讀取註記。

當使用 <command>（目前為 amend 或 rebase）重寫提交時，若此變數為 false，則 Git 不會將註記從原始提交複製到重寫後的提交。預設為 true。另請參閱下方的 notes.rewriteRef。

在重寫期間複製註記時（參見 notes.rewrite.<command> 選項），決定當目標提交已有名稱時該如何處理。必須是 overwrite、concatenate、cat_sort_uniq 或 ignore 之一。預設為 concatenate。

在重寫期間複製註記時，指定應複製其註記的（全名）參照。可以是 glob，在這種情況下將複製所有匹配參照中的註記。您也可以多次指定此配置。