限制輸出的提交數量。

在開始顯示提交輸出之前跳過 number 個提交。

顯示晚於特定日期的提交。

顯示所有晚於特定日期的提交。這會存取範圍內的所有提交，而不是停在第一個早於特定日期的提交。

顯示早於特定日期的提交。

將輸出的提交限制為具有符合指定模式（正規表示式）的作者/提交者標頭行的提交。使用多個 --author=<pattern> 時，會選擇其作者符合任何給定模式的提交（對於多個 --committer=<pattern> 也是如此）。

將輸出的提交限制為具有符合指定模式（正規表示式）的 reflog 條目的提交。使用多個 --grep-reflog 時，會選擇其 reflog 訊息符合任何給定模式的提交。除非正在使用 --walk-reflogs，否則使用此選項是錯誤的。

將輸出的提交限制為其記錄訊息符合指定模式（正規表示式）的提交。使用多個 --grep=<pattern> 時，會選擇其訊息符合任何給定模式的提交（但請參閱 --all-match）。

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

將輸出的提交限制為其記錄訊息不符合 --grep=<pattern> 指定的模式的提交。

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

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

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

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

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

當給定的路徑從樹狀結構中消失時停止。

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

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

僅顯示具有至少（或最多）該多個父提交的提交。特別是，--max-parents=1 與 --no-merges 相同，--min-parents=2 與 --merges 相同。--max-parents=0 提供所有根提交，而 --min-parents=3 提供所有章魚合併。

當尋找要包含的提交時，看到合併提交時僅追蹤第一個父提交。當檢視特定主題分支的演進時，此選項可以提供更好的概觀，因為合併到主題分支通常只是為了不時地調整為更新的上游，而此選項可讓您忽略因這種合併而帶入歷程記錄中的個別提交。

當尋找要排除的提交（使用 ^）時，看到合併提交時僅追蹤第一個父提交。這可用於在主題分支從遠端分支分歧的點找出主題分支中的變更集，前提是任意合併可以是有效的主題分支變更。

反轉所有後續修訂規範（直到下一個 --not）的 ^ 前置字元（或缺少前置字元）的含義。當在命令列上於 --stdin 之前使用時，透過 stdin 傳遞的修訂將不受其影響。相反地，當透過標準輸入傳遞時，在命令列上傳遞的修訂將不受其影響。

假裝所有在 refs/ 中的參考，連同 HEAD，都如同在命令列上列為 <commit>。

假裝所有在 refs/heads 中的參考，都如同在命令列上列為 <commit>。如果給定了 <pattern>，則限制分支為符合給定 shell glob 的分支。如果模式缺少 ?、* 或 [，則預設會在結尾加上 /*。

假裝所有在 refs/tags 中的參考，都如同在命令列上列為 <commit>。如果給定了 <pattern>，則限制標籤為符合給定 shell glob 的標籤。如果模式缺少 ?、* 或 [，則預設會在結尾加上 /*。

假裝所有在 refs/remotes 中的參考，都如同在命令列上列為 <commit>。如果給定了 <pattern>，則限制遠端追蹤分支為符合給定 shell glob 的分支。如果模式缺少 ?、* 或 [，則預設會在結尾加上 /*。

假裝所有符合 shell glob <glob-pattern> 的參考，都如同在命令列上列為 <commit>。如果缺少開頭的 refs/，則會自動加上。如果模式缺少 ?、* 或 [，則預設會在結尾加上 /*。

不要包含符合 <glob-pattern> 的參考，這些參考在下一個 --all、--branches、--tags、--remotes 或 --glob 中會被考慮。重複使用此選項會累積排除模式，直到下一個 --all、--branches、--tags、--remotes 或 --glob 選項（其他選項或參數不會清除累積的模式）。

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

假裝所有 reflog 中提到的物件都如同在命令列上列為 <commit>。

假裝所有在替代儲存庫中以參考提示形式提到的物件都如同在命令列上列出。替代儲存庫是指任何在其 objects/info/alternates 中指定了物件目錄的儲存庫。包含的物件集合可能會被 core.alternateRefsCommand 等修改。請參閱 git-config[1]。

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

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

假裝不好的二分參考 refs/bisect/bad 已被列出，並且在後面跟著 --not 和好的二分參考 refs/bisect/good-* 在命令列上。

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

如同 --cherry-pick（請參閱下方），但是用 = 標記等效的提交，而不是省略它們，並用 + 標記不等效的提交。

當提交集合使用對稱差異進行限制時，省略任何引入與「另一側」另一個提交相同變更的提交。

僅列出對稱差異各自側的提交，也就是說，僅列出會被 --left-right 標記為 < 或 > 的提交。

--right-only --cherry-mark --no-merges 的同義詞；用於限制輸出為我們這一側的提交，並使用 git log --cherry upstream...mybranch 標記已應用於分叉歷史另一側的提交，類似於 git cherry upstream mybranch。

不走訪提交的祖先鏈，而是從最新的 reflog 條目到較舊的條目走訪 reflog。當使用此選項時，您無法指定要排除的提交（也就是說，無法使用 ^commit、commit1..commit2 和 commit1...commit2 表示法）。

顯示在範圍 HEAD...<other> 中接觸到衝突路徑的提交，其中 <other> 是 MERGE_HEAD、CHERRY_PICK_HEAD、REVERT_HEAD 或 REBASE_HEAD 中的第一個現有虛擬參考。僅當索引具有未合併的條目時才有效。此選項可用於在解決三向合併中的衝突時顯示相關的提交。

輸出排除的邊界提交。邊界提交會加上 - 作為前綴。

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

選擇被某些分支或標籤引用的提交。

將歷史簡化為最簡單的歷史，以解釋樹的最終狀態。最簡單的原因是，如果最終結果相同，則會修剪一些側分支（即合併具有相同內容的分支）

包含預設模式中的所有提交，以及任何與第一個父項不 TREESAME 但與後來的父項 TREESAME 的合併提交。此模式有助於顯示「首次將」變更引入分支的合併提交。

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

僅顯示選定的提交，再加上一些提交以具有有意義的歷史。

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

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

當給定要顯示的提交範圍時（例如 commit1..commit2 或 commit2 ^commit1），僅顯示該範圍中是 <commit> 的祖先、<commit> 的後代或 <commit> 本身的提交。如果未指定任何提交，則使用 commit1（範圍的排除部分）作為 <commit>。可以多次傳遞；如果多次傳遞，則如果提交是給定的任何提交，或是它們其中之一的祖先或後代，則包含該提交。

如果 commit 對任何父節點都不是 TREESAME，則包含該 commit（雖然這可以變更，請參閱下方的 --sparse）。 如果 commit 是合併，並且對一個父節點是 TREESAME，則只追蹤該父節點。（即使有數個 TREESAME 父節點，也只追蹤其中一個。）否則，追蹤所有父節點。

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

此模式與預設模式的不同之處在於：始終追蹤合併的所有父節點，即使它對其中一個父節點是 TREESAME。 即使合併的兩側都有包含的 commit，這並不表示合併本身也包含！ 在範例中，我們得到

	I  A  B  N  D  O  P  Q

只有當一般 commit 為 !TREESAME 時才會包含（雖然這可以變更，請參閱下方的 --sparse）。

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

如果遍歷的 commit 對任何父節點都不是 TREESAME，則包含該 commit。

包含所有已遍歷的 commit。

首先，以與使用父節點重寫的 --full-history 相同的方式建立歷史圖表（請參閱上方）。

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

將顯示的 commit 限制為 <commit> 的祖先或 <commit> 的後代，或者 commit 本身。

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

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

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

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

除了預設歷史記錄中顯示的 commit 之外，還會顯示每個對其第一個父節點不是 TREESAME 但對稍後父節點為 TREESAME 的合併 commit。

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

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

在顯示任何子提交之前，不顯示任何父提交，但除此之外，按照提交時間戳記順序顯示提交。

在顯示任何子提交之前，不顯示任何父提交，但除此之外，按照作者時間戳記順序顯示提交。

在顯示任何子提交之前，不顯示任何父提交，並避免顯示來自多個歷史線的混合提交。

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

以相反的順序輸出選擇要顯示的提交 (請參閱上面的「提交限制」章節)。不能與 --walk-reflogs 組合使用。

僅顯示給定的提交，但不遍歷其祖先。如果指定範圍，則此選項無效。如果給定參數 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>」選項 (如果顯示，它也會修改 diff 輸出) 來指定前綴的最小長度。

顯示完整的 40 位元組十六進制提交物件名稱。這會否定 --abbrev-commit，無論是明確的還是由其他選項 (例如「--oneline」) 暗示的。它也會覆寫 log.abbrevCommit 變數。

這是將「--pretty=oneline --abbrev-commit」一起使用的簡寫。

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

在輸出中顯示日誌訊息之前，執行 Tab 擴展 (將每個 Tab 替換為足夠的空格，以填滿下一個顯示列，該顯示列是 <n> 的倍數)。 --expand-tabs 是 --expand-tabs=8 的簡寫，而 --no-expand-tabs 是 --expand-tabs=0 的簡寫，它會停用 Tab 擴展。

在顯示提交日誌訊息時，顯示註解提交的註解 (請參閱 git-notes[1])。當命令列上沒有給定 --pretty、--format 或 --oneline 選項時，這是 git log、git show 和 git whatchanged 指令的預設行為。

不顯示註解。這會否定上述的 --notes 選項，方法是重設顯示註解的註解 ref 清單。選項會按照在命令列上給定的順序解析，因此例如「--notes --notes=foo --no-notes --notes=bar」將只顯示來自「refs/notes/bar」的註解。

顯示預設註解，除非給定顯示特定註解的選項。

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

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

--date=relative 的同義詞。

僅適用於以人類可讀格式顯示的日期，例如在使用 --pretty 時。log.date 組態變數會為 log 指令的 --date 選項設定預設值。預設情況下，日期會以原始時區 (提交者或作者的時區) 顯示。如果將 -local 附加到格式 (例如 iso-local)，則會改用使用者的本地時區。

也列印提交的父提交 (格式為 "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>，則會顯示該字串，而不是預設的字串。