將輸出限制為應顯示的前 <number> 個提交。

將輸出限制為應顯示的最後 <number> 個提交。

在開始顯示提交輸出之前跳過 <數量> 個提交。

顯示比 <date> 更新的提交。作為特殊情況，today 指的是上一個午夜。

顯示所有比 <日期> 更新的提交。這會訪問範圍內的所有提交，而不是在遇到第一個早於 <日期> 的提交時停止。

顯示比 <日期> 更舊的提交。

將輸出提交限制在指定的日期範圍內。

將提交輸出限制為作者/提交者欄位符合 <模式> 正規表示式的提交。如果有多個 --author=<模式>，則會選擇作者符合任何一個 <模式> 的提交（多個 --committer=<模式> 亦然）。

將提交輸出限制為參照日誌 (reflog) 分錄符合 <模式> 正規表示式的提交。如果有多個 --grep-reflog，則會選擇其參照日誌訊息符合任何給定模式的提交。除非使用了 --walk-reflogs，否則使用此選項會發生錯誤。

將提交輸出限制為日誌訊息符合 <模式> 正規表示式的提交。如果有多個 --grep=<模式>，則會選擇訊息符合任何一個 <模式> 的提交（但請參閱 --all-match）。

將提交輸出限制為符合所有給定 --grep 的提交，而不是符合至少一個的提交。

將提交輸出限制為日誌訊息不符合 --grep=<模式> 指定之 <模式> 的提交。

在比對正規表示式限制模式時不區分大小寫。

將限制模式視為基本正規表示式 (BRE)；這是預設值。

將限制模式視為擴展正規表示式 (ERE)，而不是預設的基本正規表示式。

將限制模式視為固定字串（不將模式解釋為正規表示式）。

將限制模式視為 Perl 相容的正規表示式 (PCRE)。

當給定路徑從樹中消失時停止。

僅列印合併提交。這與 --min-parents=2 完全相同。

不要列印具有多個父提交的提交。這與 --max-parents=1 完全相同。

僅顯示具有至少（或最多）多個父提交的提交。具體來說，--max-parents=1 等同於 --no-merges，--min-parents=2 等同於 --merges。--max-parents=0 會給出所有根提交，而 --min-parents=3 則給出所有章魚合併 (octopus merges)。

在尋找要包含的提交時，遇到合併提交僅跟隨第一個父提交。在查看特定主題分支的演變時，此選項可以提供更好的概覽，因為合併到主題分支通常只是為了不時調整以適應更新的上游，而此選項允許您忽略此類合併引入到您的歷史記錄中的個別提交。

在尋找要排除的提交時（使用 ^），在遇到合併提交時僅跟隨第一個父提交。這可以用於查找主題分支中從其偏離遠端分支之點開始的變更集，前提是任意合併都可以是有效的主題分支變更。

將輸出提交限制為無法從修訂版本範圍內任何其他提交可達的那些提交。

反轉所有後續修訂版本指定符的 ^ 前綴（或缺少前綴）的含義，直到下一個 --not。當在命令列中的 --stdin 之前使用時，通過 stdin 傳遞的修訂版本將不受其影響。反之，當通過標準輸入傳遞時，在命令列中傳遞的修訂版本將不受其影響。

假裝命令列中列出了 refs/ 中的所有參照以及 HEAD 作為 <提交>。

假裝命令列中列出了 refs/heads 中的所有參照作為 <提交>。如果給定了 <模式>，則將分支限制為符合給定 shell 全域比對模式 (glob) 的分支。如果模式中缺少 ?、* 或 [，則隱含結尾處為 /*。

假裝命令列中列出了 refs/tags 中的所有參照作為 <提交>。如果給定了 <模式>，則將標籤限制為符合給定 shell 全域比對模式的標籤。如果模式中缺少 ?、* 或 [，則隱含結尾處為 /*。

假裝命令列中列出了 refs/remotes 中的所有參照作為 <提交>。如果給定了 <模式>，則將遠端追蹤分支限制為符合給定 shell 全域比對模式的分支。如果模式中缺少 ?、* 或 [，則隱含結尾處為 /*。

假裝命令列中列出了所有符合 shell 全域比對模式 <全域比對模式> 的參照作為 <提交>。如果缺少領頭的 refs/，會自動補上。如果模式中缺少 ?、* 或 [，則隱含結尾處為 /*。

不要包含符合 <全域比對模式> 的參照，否則下一個 --all、--branches、--tags、--remotes 或 --glob 會考慮這些參照。重複此選項會累積排除模式，直到遇到下一個 --all、--branches、--tags、--remotes 或 --glob 選項為止（其他選項或引數不會清除累積的模式）。

參考對應的 fetch.hideRefs、receive.hideRefs 或 uploadpack.hideRefs 設定以及 transfer.hideRefs，不要包含會被 git-fetch、git-receive-pack 或 git-upload-pack 隱藏的參照（請參閱 git-config[1]）。此選項會影響下一個虛擬參照選項 --all 或 --glob，並在處理後清除。

假裝參照日誌 (reflog) 提到的所有物件都作為 <提交> 列在命令列中。

假裝備份儲存庫（alternate repositories）的參照頂端提到的所有物件都列在命令列中。備份儲存庫是指在 objects/info/alternates 中指定其物件目錄的任何儲存庫。包含的物件集可以由 core.alternateRefsCommand 等修改。請參閱 git-config[1]。

預設情況下，當存在多個工作樹時，下列選項會檢查所有工作樹（請參閱 git-worktree[1]）：--all、--reflog 和 --indexed-objects。此選項強制它們僅檢查目前工作樹。

在輸入中看到無效的物件名稱時，假裝沒有給出該錯誤輸入。

除了從命令列獲取引數外，也從標準輸入讀取引數。這接受提交和類似 --all 和 --glob= 的虛擬選項。當看到 -- 分隔符時，後續輸入將被視為路徑並用於限制結果。通過標準輸入讀取的標記（如 --not）僅對以相同方式傳遞的引數有效，不會影響任何後續的命令列引數。

不要將任何內容列印到標準輸出。此模式主要是為了讓呼叫者測試退出狀態，以查看物件範圍是否完全連接（或不連接）。由於無需格式化輸出，這比將 stdout重新導向到 /dev/null 更快。

抑制常規輸出；改為列印所選提交或物件在磁碟上儲存所佔用的位元組總和。這等同於將輸出導向至 git cat-file --batch-check='%(objectsize:disk)，但執行速度快得多（特別是與 --use-bitmap-index 一起使用時）。有關「磁碟儲存」含義的限制，請參閱 git-cat-file[1] 中的 CAVEATS 章節。使用選用值 human 時，磁碟儲存大小將以人類可讀的字串顯示（例如 12.24 Kib, 3.50 Mib）。

類似於 --cherry-pick（見下文），但用 = 標記等效的提交而不是省略它們，並用 + 標記不等效的提交。

當提交集以對稱差（symmetric difference）受限時，省略任何引入與“另一側”另一個提交相同變更的提交。

僅列出對稱差中相應一側的提交，即僅列出會被 --left-right 標記為 < 或 > 的提交。

--right-only --cherry-mark --no-merges 的同義詞；對於將輸出限制在我們這一側的提交，並用 git log --cherry upstream...mybranch（類似於 git cherry upstream mybranch）標記那些已套用到分叉歷史另一側的提交非常有用。

遍歷參照日誌分錄（從最新到最舊），而不是遍歷提交祖先鏈。使用此選項時，您不能指定要排除的提交（即不能使用 ^<提交>、<提交1>..<提交2> 和 <提交1>...<提交2> 記法）。

顯示範圍 HEAD...<other> 內涉及衝突路徑的提交，其中 <other> 是 MERGE_HEAD、CHERRY_PICK_HEAD、REVERT_HEAD 或 REBASE_HEAD 中第一個存在的虛擬參照。僅在索引具有未合併分錄時才有效。此選項可用於在解決三方合併衝突時顯示相關提交。

輸出排除的邊界提交。邊界提交以前綴 - 標示。

嘗試使用打包點陣圖索引（若可用）加速遍歷。請注意，使用 --objects 遍歷時，樹狀物件和二進位大物件（blob）將不會列印其相關路徑。

當考慮物件時，在 stderr 上顯示進度報告。<header> 文字將隨著每個進度更新一起列印。

每個輸出的物件及其附帶的元資料不再使用換行符分隔，而是使用 NUL 位元組分隔。輸出格式如下

<OID> NUL [<token>=<value> NUL]...

<OID> NUL
<OID> NUL path=<path> NUL
<OID> NUL boundary=yes NUL
<OID> NUL missing=yes NUL [<token>=<value> NUL]...

選擇修改給定 <路徑> 的提交。

選擇被某些分支或標籤參照的提交。

將歷史簡化為解釋樹的最終狀態的最簡歷史。最簡是因為如果最終結果相同（即合併內容相同的分支），它會剪除一些側邊分支。

包含預設模式下的所有提交，但也包含任何與第一個父提交不 TREESAME 但與後面的父提交 TREESAME 的合併提交。此模式有助於顯示 "首次引入" 變更至分支的合併提交。

與預設模式相同，但不剪除某些歷史。

僅顯示選定的提交，加上一些為了構成有意義歷史的提交。

顯示簡化歷史中的所有提交。

--full-history 的附加選項，用於從結果歷史中刪除一些不必要的合併，因為沒有選定的提交對此合併有貢獻。

當給定要顯示的提交範圍（例如 <提交1>..<提交2> 或 <提交2> ^<提交1>）以及該範圍內的一個提交 <提交> 時，僅顯示該範圍內是 <提交> 的祖先、<提交> 的後代或 <提交> 本身的提交。如果未指定提交，則使用 <提交1>（範圍中排除的部分）作為 <提交>。可以多次傳遞；如果多次傳遞，則提交若為給定的任何提交或其祖先或後代，則會被包含在內。

如果提交與任何父提交都不是 TREESAME，則包含這些提交（儘管這可以更改，請參見下面的 --sparse）。如果提交是合併提交，且與一個父提交是 TREESAME，則僅跟隨該父提交。（即使有多個 TREESAME 父提交，也僅跟隨其中一個。）否則，跟隨所有父提交。

	  .-A---N---O
	 /     /   /
	I---------D

此模式與預設模式在一點上不同：始終跟隨合併的所有父提交，即使它與其中一個父提交是 TREESAME。即使合併的多個方面都有被包含的提交，這並不意味著合併本身也被包含！在範例中，我們得到：

	I  A  B  N  D  O  P  Q

普通提交僅在它們是 !TREESAME 時才被包含（儘管這可以更改，請參閱下面的 --sparse）。

	  .-A---M---N---O---P---Q
	 /     /   /   /   /
	I     B   /   D   /
	 \   /   /   /   /
	  `-------------'

被遍歷的提交如果與任何父提交都不是 TREESAME，則會被包含。

所有被遍歷的提交都會被包含。

首先，以與包含父提交重寫的 --full-history 相同的方式構建歷史圖（見上文）。

	  .-A---M---N---O
	 /     /       /
	I     B       D
	 \   /       /
	  `---------'

將顯示的提交限制為那些是 <提交> 的祖先、後代或 <提交> 本身的提交。

	    D---E-------F
	   /     \       \
	  B---C---G---H---I---J
	 /                     \
	A-------K---------------L--M

		E-------F
		 \       \
		  G---H---I---J
			       \
				L--M

		E
		 \
	      C---G---H---I---J
			       \
				L--M

		K---------------L--M

除了預設歷史中顯示的提交外，還顯示每個與其第一父提交不是 TREESAME 但與後面父提交是 TREESAME 的合併提交。

	I---X---R---N

	  .-A---M--.   N
	 /     /    \ /
	I     B      R
	 \   /      /
	  \ /      /
	   `---X--'

將輸出限制在包含與排除提交之間大致位於中間位置的一個提交物件。請注意，錯誤的二分參考 refs/bisect/bad 會被加入包含的提交（若存在），而良好的二分參考 refs/bisect/good-* 會被加入排除的提交（若存在）。因此，假設 refs/bisect/ 中沒有參考，如果

	$ git rev-list --bisect foo ^bar ^baz

	$ git rev-list foo ^midpoint
	$ git rev-list midpoint ^bar ^baz

這會計算與 --bisect 相同的結果，除了不使用 refs/bisect/ 中的參考，並且此輸出格式可供 shell 直接 eval。這些行會將中點修訂版本名稱指派給變數 bisect_rev，將 bisect_rev 測試後預期要測試的提交數量指派給 bisect_nr，若 bisect_rev 結果為好，預期要測試的提交數量指派給 bisect_good，若 bisect_rev 結果為壞，預期要測試的提交數量指派給 bisect_bad，並將目前我們正在二分搜尋的提交數量指派給 bisect_all。

這會輸出包含和排除提交之間的所有提交物件，並根據它們與包含和排除提交的距離進行排序。不使用 refs/bisect/ 中的參考。距離它們最遠的會優先顯示。（這是 --bisect 唯一顯示的一個。）

在顯示所有子節點之前不顯示父節點，除此之外按提交時間戳記順序顯示提交。

在顯示所有子節點之前不顯示父節點，除此之外按作者時間戳記順序顯示提交。

在顯示所有子節點之前不顯示父節點，並避免交替顯示多條歷史線上的提交。

    ---1----2----4----7
	\	       \
	 3----5----6----8---

以反向順序輸出選擇顯示的提交（參見上方的「提交限制」章節）。不能與 --walk-reflogs 結合使用。

列印列出的提交所參考的任何物件的 ID。--objects foo ^bar 因此意指「如果我擁有提交物件 bar 但沒有 foo，請傳送給我我需要下載的所有物件 ID」。另請參閱下方的 --object-names。

按提交順序列印樹狀物件和二進位物件 ID。樹狀物件和二進位物件 ID 會在首次被提交參考後列印。

與 --objects 類似，但也會列印被排除提交的 ID，並以「-」字元作為前綴。這由 git-pack-objects[1] 用於構建「瘦（thin）」包，它基於這些被排除提交中包含的物件以差異形式記錄物件，從而減少網路流量。

與 --objects-edge 類似，但它會以增加時間為代價，更努力地尋找被排除的提交。這取代了 --objects-edge 用於為淺層儲存庫構建「瘦（thin）」包。

假裝索引使用的所有樹狀物件和二進位物件都列在命令列上。請注意，您可能也想使用 --objects。

僅在與 --objects 一起使用時才有用；列印不在打包檔案中的物件 ID。

僅在與 --objects 一起使用時才有用；列印找到的物件 ID 的名稱。這是預設行為。請注意，每個物件的「名稱」是模稜兩可的，主要旨在作為打包物件的提示。特別是：標籤、樹狀物件和二進位物件的名稱之間沒有區別；路徑名稱可能會被修改以刪除換行符；如果一個物件以不同名稱出現多次，則只會顯示一個名稱。

僅在與 --objects 一起使用時才有用；不列印找到的物件 ID 的名稱。這會反轉 --object-names。此標記允許輸出更容易被諸如 git-cat-file[1] 等指令解析。

僅在與 --objects* 其中之一一起使用時才有用；從列印的物件清單中省略物件（通常是二進位物件）。<filter-spec> 可以是下列其中之一

關閉任何先前的 --filter= 引數。

過濾明確提供的物件清單，否則這些物件即使不符合任何過濾器也始終會被列印。僅在與 --filter= 一起使用時才有用。

僅在與 --filter= 一起使用時才有用；列印被過濾器省略的物件清單。物件 ID 以「~」字元作為前綴。

一個有助於未來「部分複製（partial clone）」開發的除錯選項。此選項指定如何處理缺失的物件。

（僅限內部使用。）在 promisor 邊界進行物件遍歷預過濾。這與部分複製一起使用。這比 --missing=allow-promisor 更強大，因為它限制了遍歷，而不僅僅是忽略有關缺失物件的錯誤。

僅顯示指定的提交，但不遍歷其祖先。如果指定了範圍，則此選項無效。如果指定了 unsorted 參數，則提交會按命令列中指定的順序顯示。否則（如果指定了 sorted 或未指定參數），提交會按提交時間的反向時間順序顯示。不能與 --graph 結合使用。

覆蓋之前的 --no-walk。

以指定格式美化列印提交日誌的內容，其中 <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 的簡寫，後者會停用製表符擴展。

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

--date=relative 的同義詞。

僅對以人類可讀格式顯示的日期生效，例如使用 --pretty 時。log.date 配置變數為 log 指令的 --date 選項設定了預設值。預設情況下，日期以原始時區（提交者或作者的時區）顯示。如果將 -local 附加到格式（例如 iso-local），則改為使用使用者的本地時區。

以原始格式列印提交內容；每條記錄以 NUL 字元分隔。

抑制在指定格式之前列印包含「commit」和物件 ID 的標頭行。這對內建格式無效；僅影響自訂格式。

覆寫先前的 --no-commit-header。

同時列印提交的父系（格式為「commit parent…」）。也會啟用父系重寫，請參閱上方的「歷史簡化」。

同時列印提交的子系（格式為「commit child…」）。也會啟用父系重寫，請參閱上方的「歷史簡化」。

列印原始提交時間戳記。

標記提交是從對稱差集的哪一側可到達。左側的提交以 < 為前綴，右側的以 > 為前綴。如果與 --boundary 結合使用，這些提交將以 - 為前綴。

	     y---b---b  branch B
	    / \ /
	   /   .
	  /   / \
	 o---x---a---a  branch A

	$ git rev-list --left-right --boundary --pretty=oneline A...B

	>bbbbbbb... 3rd on b
	>bbbbbbb... 2nd on b
	<aaaaaaa... 3rd on a
	<aaaaaaa... 2nd on a
	-yyyyyyy... 1st on b
	-xxxxxxx... 1st on a

在輸出的左側繪製提交歷史的基於文字的圖形表示。為了正確繪製圖形歷史，這可能會導致在提交之間列印額外的行。不能與 --no-walk 結合使用。

當不使用 --graph 時，所有歷史分支都會被扁平化，這可能使人難以看出兩個連續的提交不屬於線性分支。在此情況下，此選項會在它們之間放置一個屏障。如果指定了 <barrier>，則它是將顯示而不是預設字串的字串。

當使用 --graph 時，限制顯示的圖形通道（lanes）數量。超過限制的通道會被截斷標記 ~ 取代。預設值為 0（無限制），零和負值將被忽略並視為無限制。

列印一個數字，說明本應列出多少個提交，並抑制所有其他輸出。當與 --left-right 一起使用時，改為列印左側和右側提交的計數，並以製表符分隔。當與 --cherry-mark 一起使用時，從這些計數中省略補丁等效的提交，並列印等效提交的計數，以製表符分隔。