如果提供了一個或多個 <pattern> 引數，則只顯示與至少一個模式匹配的 ref，匹配可以是使用 fnmatch(3) 或字面量匹配，後一種情況則完全匹配或從開頭匹配到斜槓。

模式列表從標準輸入讀取，而不是從引數列表中讀取。

顯示 <count> 個 ref 後停止。

按欄位名稱 <key> 排序。字首 - 表示按值降序排序。未指定時，預設為 refname。您可以多次使用 --sort=<key> 選項，在這種情況下，最後一個鍵將成為主鍵。

一個字串，它將來自正在顯示的 ref 及其指向物件的 %(fieldname) 進行插值。此外，字串字面量 %% 渲染為 %，而 %xx（其中 xx 是十六進位制數字）則渲染為具有十六進位制程式碼 xx 的字元。例如，%00 插值為 \0 (NUL)，%09 插值為 \t (TAB)，%0a 插值為 \n (LF)。

尊重 --format 選項中指定的任何顏色。<when_ 欄位必須是 always、never 或 auto 之一（如果<when> 缺失，則行為如同指定了 always）。

如果給出，則替換 %(fieldname) 佔位符的字串將被引用為適合指定宿主語言的字串字面量。這旨在生成一個可以被“eval”直接求值的指令碼片段。

只列出指向給定物件的 ref。

僅列出其提示（tips）可從指定提交（如果未指定則為 HEAD）可達的 ref。

僅列出其提示（tips）不可從<object>（如果未指定則為 HEAD）可達的 ref。

僅列出包含<object>（如果未指定則為 HEAD）的 ref。

僅列出不包含<object>（如果未指定則為 HEAD）的 ref。

排序和過濾 ref 時不區分大小寫。

在格式化引用中，如果格式擴充套件為空字串，則不在其後列印換行符。

如果提供了一個或多個 --exclude 選項，則只顯示不匹配任何 <excluded-pattern> 引數的 ref。匹配使用與上面 <pattern> 相同的規則進行。

列出根 ref（HEAD 和偽 ref），與普通 ref 分開。

允許透過跳過直到幷包括指定標記的引用來分頁輸出。在分頁時，應注意引用可能在呼叫之間被刪除、修改或新增。輸出將僅顯示那些在字母順序上跟隨標記的引用。輸出從在標記之後字母順序上出現的第一個引用開始。不能與 --sort=<key> 或 --stdin 選項，或用於限制 ref 的 <pattern> 引數一起使用。

ref 的名稱（$GIT_DIR/ 之後的ส่วน）。對於 ref 的非歧義短名稱，追加 :short。選項 core.warnAmbiguousRefs 用於選擇嚴格縮寫模式。如果追加 lstrip=<n>（rstrip=<n>），則從 refname 的開頭（結尾）剝離 <n> 個斜槓分隔的路徑元件（例如，%(refname:lstrip=2) 將 refs/tags/foo 轉換為 foo，而 %(refname:rstrip=2) 將 refs/tags/foo 轉換為 refs）。如果 <n> 是負數，則從指定末尾剝離儘可能多的路徑元件，以留下 -<n> 個路徑元件（例如，%(refname:lstrip=-2) 將 refs/tags/foo 轉換為 tags/foo，而 %(refname:rstrip=-1) 將 refs/tags/foo 轉換為 refs）。當 ref 沒有足夠的元件時，如果用正數 <n> 剝離，結果將為空字串；如果用負數 <N> 剝離，則結果是完整的 refname。兩者都不是錯誤。

物件的型別（blob、tree、commit、tag）。

物件的大小（與 git cat-file -s 報告的大小相同）。追加 :disk 以獲取物件在磁碟上佔用的位元組數。有關磁碟大小的說明，請參見下文的 注意事項 部分。

物件名稱（又名 SHA-1）。對於物件名稱的非歧義縮寫，追加 :short。對於所需長度的物件名稱縮寫，追加 :short=<length>，其中最小長度為 MINIMUM_ABBREV。長度可以超出以確保物件名稱的唯一性。

這會擴充套件為給定物件的 delta 基物件的名稱（如果它被儲存為 delta）。否則，它會擴充套件為 null 物件名稱（全零）。

可以被認為是相對於顯示 ref 的“上游”的本地 ref 的名稱。它以與 refname 相同的方式響應 :short、:lstrip 和 :rstrip。此外，它響應 :track 以顯示 "[ahead N, behind M]"，以及 :trackshort 以顯示簡潔版本：">"（落後）、"<"（超前）、"<>"（同時落後和超前）或 "="（同步）。當遇到未知上游 ref 時，:track 還會列印 "[gone]"。 追加 :track,nobracket 可在不帶括號的情況下顯示跟蹤資訊（即 "ahead N, behind M"）。

代表顯示 ref 的 @{push} 位置的本地 ref 的名稱。它以與 upstream 相同的方式響應 :short、:lstrip、:rstrip、:track、:trackshort、:remotename 和 :remoteref 選項。如果未配置 @{push} ref，則生成空字串。

如果 HEAD 匹配當前 ref（已檢出的分支），則為“*”，否則為“ ”。

更改輸出顏色。後面跟著 :<colorname>，其中顏色名稱在 git-config[1] 的“CONFIGURATION FILE”部分中描述。例如，%(color:bold red)。

左對齊、居中對齊或右對齊 %(align:...) 和 %(end) 之間的內容。"align:" 後面跟著 width=<width> 和 position=<position>，順序任意，用逗號分隔，其中 <position> 是 left、right 或 middle，預設為 left，<width> 是帶有對齊的內容的總長度。為簡潔起見，可以省略 "width=" 和/或 "position=" 字首，而使用裸的 <width> 和 <position>。例如，%(align:<width>,<position>)。如果內容長度超過寬度，則不進行對齊。如果與 --quote 一起使用，則 %(align:...) 和 %(end) 之間的所有內容都將被引用，但如果巢狀，則只有最頂層執行引用。

用作 %(if)...%(then)...%(end) 或 %(if)...%(then)...%(else)...%(end)。如果 %(if) 之後有一個具有值或字串字面量的原子，則列印 %(then) 之後的所有內容；否則，如果使用了 %(else) 原子，則列印 %(else) 之後的所有內容。我們在評估 %(then) 之前的字串時會忽略空格，這在使用 %(HEAD) 原子（它列印“*”或“ ”）時非常有用，並且我們只想對 HEAD ref 應用 if 條件。追加 ":equals=<string>" 或 ":notequals=<string>" 來比較 %(if:...) 和 %(then) 原子與給定字串之間的值。

給定的符號 ref 指向的 ref。如果不是符號 ref，則不列印任何內容。它以與 refname 相同的方式響應 :short、:lstrip 和 :rstrip 選項。

提交的 GPG 簽名。

顯示

提交的 GPG 簽名的簽名者。

提交的 GPG 簽名的金鑰。

提交的 GPG 簽名的指紋。

提交的 GPG 簽名的主金鑰指紋。

提交的 GPG 簽名的信任級別。可能的輸出是 ultimate、fully、marginal、never 和 undefined。

如果 ref 在任何連結的工作樹中被檢出，則為該工作樹的絕對路徑。否則為空字串。

兩個整數，用空格分隔，分別表示在將輸出 ref 與格式中指定的 <committish> 進行比較時，超前和落後提交的數量。

最多在一行中，將出現 (<commit-ish>) 來指示最有可能用作產生 <commit-ish> 的分支起點的 ref。此選擇是使用啟發式方法做出的：選擇最小化 <commit-ish> 的第一父提交歷史中不在 ref 的第一父提交歷史中的提交數量的 ref。

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

一個人類可讀的名稱，類似於 git-describe[1]；對於無法描述的提交，則為空字串。describe 字串後面可以跟一個冒號和一種或多種逗號分隔的選項。

物件的原始資料大小。

提交或標籤訊息的位元組大小。

訊息的第一段，通常是單行，被視為提交或標籤訊息的“主題”。除了 contents:subject，還可以使用 subject 欄位來獲得相同的結果。可以在 subject 後附加 :sanitize 以獲得適合作為檔名的主題行。

提交或標籤訊息中位於“主題”之後的部分。

標籤的可選 GPG 簽名。

訊息的前 <n> 行。