限制要輸出的提交數量。

在開始顯示提交輸出之前跳過 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 的分支。如果 pattern 缺少 ?、* 或 [，則會隱含在結尾加上 /*。

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

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

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

不要包含符合 <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。此選項強制它們只檢查目前的工作樹。

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

除了從命令列取得引數之外，也從標準輸入讀取它們。這接受提交和虛擬選項，例如 --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 類似（請參閱下方），但以 = 而不是省略來標記等效提交，並以 + 來標記不等效提交。

當提交集受到對稱差異限制時，省略任何引入與「另一邊」的另一個提交相同變更的提交。

僅列出對稱差異的各自側的提交，也就是說，僅列出會被 --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 中第一個存在的虛擬參照。僅當索引具有未合併的項目時才有效。當解決三方合併的衝突時，可以使用此選項來顯示相關的提交。

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

嘗試使用封裝點陣圖索引來加速追蹤（如果有的話）。請注意，當使用 --objects 追蹤時，樹狀結構和 blob 不會列印其關聯的路徑。

在考量物件時，於 stderr 上顯示進度報告。 <header> 文字將會隨著每次進度更新印出。

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

選取由某些分支或標籤引用的提交。

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

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

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

只顯示選定的提交，以及一些以提供有意義的歷史。

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

--full-history 的額外選項，可從產生的歷史中移除一些不必要的合併，因為沒有選定的提交有助於此合併。

當給定要顯示的提交範圍（例如 commit1..commit2 或 commit2 ^commit1）時，只顯示該範圍中 <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
		 \
		  G---H---I---J
			       \
				L--M

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

除了預設歷史中顯示的 commit 之外，還顯示每個與其第一個父節點不是 TREESAME 但與後續父節點是 TREESAME 的合併 commit。

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

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

將輸出限制為包含的 commit 和排除的 commit 之間大致中間的單一 commit 物件。請注意，錯誤的二分查找參考 refs/bisect/bad 會被新增到包含的 commit 中（如果它存在），而正確的二分查找參考 refs/bisect/good-* 會被新增到排除的 commit 中（如果它們存在）。因此，假設 refs/bisect/ 中沒有參考，如果

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

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

此選項的計算方式與 --bisect 相同，不同之處在於不會使用 refs/bisect/ 中的參考，而且此選項會輸出準備好讓 shell 執行的文字。這些行會將中點修訂版本的名稱指定給變數 bisect_rev，並將預期在測試 bisect_rev 後要測試的 commit 數量指定給 bisect_nr，如果 bisect_rev 結果是正確的，則預期要測試的 commit 數量指定給 bisect_good，如果 bisect_rev 結果是錯誤的，則預期要測試的 commit 數量指定給 bisect_bad，以及我們目前正在進行二分查找的 commit 數量指定給 bisect_all。

此選項會輸出包含的 commit 和排除的 commit 之間的所有 commit 物件，並依它們與包含的 commit 和排除的 commit 的距離排序。不會使用 refs/bisect/ 中的參考。距離最遠的會先顯示。（這是 --bisect 唯一會顯示的。）

在顯示其所有子節點之前不顯示任何父節點，但其他情況下會以 commit 時間戳記順序顯示 commit。

在顯示其所有子節點之前不顯示任何父節點，但其他情況下會以作者時間戳記順序顯示 commit。

在顯示其所有子節點之前不顯示任何父節點，並避免顯示混合在一起的多條歷史記錄線上的 commit。

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

以反向順序輸出選擇要顯示的 commit (請參閱上面的 Commit 限制章節)。無法與 --walk-reflogs 組合使用。

列印所列 commit 引用的任何物件的物件 ID。因此，--objects foo ^bar 表示「如果我有 commit 物件 _bar_ 但沒有 _foo_，請傳送給我所有我需要下載的物件 ID」。另請參閱下面的 --object-names。

依 commit 的順序列印樹狀和 blob ID。樹狀和 blob ID 會在第一次被 commit 引用後列印。

與 --objects 類似，但也會列印以「-」字元為前綴的排除 commit 的 ID。 git-pack-objects[1] 使用此選項來建置「精簡」封裝，該封裝會根據這些排除 commit 中包含的物件，以差異化的形式記錄物件，以減少網路流量。

與 --objects-edge 類似，但它會花費更多時間來嘗試尋找排除的 commit。會使用此選項而不是 --objects-edge 來為淺層儲存庫建置「精簡」封裝。

假裝索引使用的所有樹狀和 blob 都已在命令列上列出。請注意，您可能也想要使用 --objects。

僅與 --objects 一起使用；列印不在封裝中的物件 ID。

僅與 --objects 一起使用；列印找到的物件 ID 的名稱。這是預設行為。請注意，每個物件的「名稱」含糊不清，主要目的是作為封裝物件的提示。特別是：不會區分標籤、樹狀和 blob 的名稱；路徑名稱可能會被修改以移除換行符號；如果物件會多次以不同的名稱出現，則只會顯示一個名稱。

僅與 --objects 一起使用；不會列印找到的物件 ID 的名稱。這會反轉 --object-names。此旗標允許 git-cat-file[1] 等命令更輕鬆地解析輸出。

僅對 --objects* 其中之一有用；從列印的物件清單中省略物件 (通常是 blob)。_<filter-spec>_ 可以是下列其中一種

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

篩選明確提供的物件清單，否則即使它們與任何篩選器都不匹配，這些物件也總是會被印出。僅在與 --filter= 一起使用時才有用。

僅在與 --filter= 一起使用時才有用；印出篩選器省略的物件清單。物件 ID 以 “~” 字元為前綴。

一個除錯選項，用於協助未來「部分克隆」開發。此選項指定如何處理遺失的物件。

（僅供內部使用。）在 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>」（如果顯示的話，也會修改 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 展開。

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

--date=relative 的同義詞。

僅對以人類可讀格式顯示的日期生效，例如使用 --pretty 時。log.date 設定變數會為日誌命令的 --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>，則會顯示該字串，而不是預設的字串。

印出一個數字，表示將被列出的提交數量，並抑制所有其他輸出。當與 --left-right 一起使用時，會改為印出左側和右側提交的計數，並以 Tab 分隔。當與 --cherry-mark 一起使用時，會從這些計數中省略修補程式等效提交，並印出等效提交的計數，以 Tab 分隔。