限制輸出的提交數量。

在開始顯示提交輸出之前跳過 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 之前使用時，透過標準輸入傳遞的修訂版本不會受其影響。相反，當透過標準輸入傳遞時，命令列中傳遞的修訂版本不會受其影響。

假裝 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 選項（其他選項或引數不會清除累積的模式）。

根據適當的 fetch.hideRefs、receive.hideRefs 或 uploadpack.hideRefs 配置以及 transfer.hideRefs（參見 git-config[1]），不包含會被 git-fetch、git-receive-pack 或 git-upload-pack 隱藏的引用。此選項影響下一個偽引用選項 --all 或 --glob，並在處理後清除。

假裝引用日誌中提及的所有物件都作為 <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 條目進行遍歷。使用此選項時，不能指定要排除的提交（即，不能使用 ^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> 的後代或 <commit> 本身的提交。如果沒有指定提交，則使用 commit1（範圍中排除的部分）作為 <commit>。可以多次傳遞；如果是這樣，如果提交是給定提交中的任何一個，或者它是其中一個的祖先或後代，則包含該提交。

如果提交與任何父提交不是 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
	 \   /       /
	  `---------'

限制顯示的提交，使其為 <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
		 \
	      C---G---H---I---J
			       \
				L--M

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

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

	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>" 選項（如果顯示差異輸出，此選項也會對其進行修改）來指定字首的最小長度。

顯示完整的 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 並顯示輸出來檢查已簽名提交物件的有效性。

等同於 --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>，它將是代替預設字串顯示的字串。