將輸出限制為 <number> 個提交。

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

顯示比 <date> 更新的提交。

顯示所有比 <date> 更新的提交。這會遍歷範圍內的所有提交，而不是在第一個比 <date> 舊的提交處停止。

顯示比 <date> 舊的提交。

將提交輸出限制在指定的時間範圍內。

將提交輸出限制為作者/提交者標題行與 <pattern> 正則表示式匹配的提交。使用多個 --author=<pattern> 時，會選擇作者匹配任何 <pattern> 的提交（對多個 --committer=<pattern> 類似）。

將提交輸出限制為 reflog 條目與 <pattern> 正則表示式匹配的提交。使用多個 --grep-reflog 時，會選擇 reflog 訊息匹配任何給定模式的提交。使用此選項但未同時使用 --walk-reflogs 是錯誤的。

將提交輸出限制為其日誌訊息匹配 <pattern> 正則表示式的提交。使用多個 --grep=<pattern> 時，會選擇訊息匹配任何 <pattern> 的提交（但請參閱 --all-match）。

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

將提交輸出限制為其日誌訊息不匹配使用 --grep=<pattern> 指定的 <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 匹配的標籤。如果模式缺少 ?、* 或 [，則在末尾隱含 /*。

假裝 refs/remotes 中的所有引用都已在命令列上列為 <commit>。如果給出了 <pattern>，則將遠端跟蹤分支限制為與給定 shell glob 匹配的分支。如果模式缺少 ?、* 或 [，則在末尾隱含 /*。

假裝所有匹配 shell glob <glob-pattern> 的引用都已在命令列上列為 <commit>。如果缺少，則自動加上字首 refs/。如果模式缺少 ?、* 或 [，則在末尾隱含 /*。

不包括與下一個 --all、--branches、--tags、--remotes 或 --glob 將要考慮的 <glob-pattern> 匹配的引用。此選項的重複使用會累積排除模式，直到下一個 --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，並在處理它們之後清除。

假裝由 reflog 提及的所有物件都已在命令列上列為 <commit>。

假裝備用儲存庫的引用尖端中提到的所有物件都已在命令列上列出。備用儲存庫是其物件目錄在 objects/info/alternates 中指定的任何儲存庫。包含的物件集可能由 core.alternateRefsCommand 等修改。請參閱 git-config[1]。

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

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

除了從命令列獲取引數外，還可以從標準輸入讀取它們。這接受提交和偽選項，如 --all 和 --glob=。當看到 -- 分隔符時，後面的輸入被視為路徑並用於限制結果。透過 stdin 讀取的標誌（如 --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 條目。使用此選項時，您不能指定要排除的提交（即，不能使用 ^<commit>、<commit1>..<commit2> 和 <commit1>...<commit2> 表示法）。

顯示在 HEAD...<other> 範圍內接觸已衝突路徑的提交，其中 <other> 是 MERGE_HEAD、CHERRY_PICK_HEAD、REVERT_HEAD 或 REBASE_HEAD 中的第一個存在的偽引用。僅當索引包含未合併條目時才有效。此選項可用於在解決 3 路合併衝突時顯示相關提交。

輸出排除的邊界提交。邊界提交字首為 -。

嘗試使用 pack bitmap 索引（如果可用）來加速遍歷。請注意，在使用 --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]...

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

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

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

包含預設模式中的所有提交，但也包括任何與第一個父提交不 TREESAME 但與較晚的父提交 TREESAME 的合併提交。此模式有助於顯示“首次引入”更改到分支的合併提交。

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

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

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

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

當給定一個要顯示的提交範圍（例如 <commit1>..<commit2> 或 <commit2> ^<commit1>），以及該範圍內的提交 <commit> 時，只顯示在該範圍內是 <commit> 的祖先、<commit> 的後代，或者 <commit> 本身的提交。如果沒有指定提交，則將 <commit1>（範圍中排除的部分）用作 <commit>。可以多次傳遞；如果是這樣，如果一個提交是給定的任何提交之一，或者它是其中一個的祖先或後代，則包含該提交。

包含的提交是那些與任何父項都不同的提交（儘管這可以改變，請參見下文的 --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--'

將輸出限制為包含提交和排除提交之間大致中間的那個提交物件。請注意，錯誤的二分法引用 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 求值。這些行將中間修訂版的名稱賦給變數 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。

按提交順序列印樹和 blob ID。樹和 blob ID 在首次被提交引用後列印。

類似於 --objects，但也列印排除提交的 ID，前面加上 "-" 字元。這由 git-pack-objects[1] 使用來構建“瘦” pack，它以增量形式記錄物件，基於這些排除提交中的物件，以減少網路流量。

類似於 --objects-edge，但它會更努力地尋找排除的提交，但代價是增加時間。這被用於代替 --objects-edge 來構建淺倉庫的“瘦” pack。

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

僅與 --objects 有效；列印不在 pack 中的物件 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` 的簡寫。

提交物件在它們的 encoding 頭中記錄了日誌訊息使用的字元編碼；此選項可用於告訴命令將提交日誌訊息重新編碼為使用者首選的編碼。對於非底層命令，預設為 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` 配置變數為 `git 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>，則它將是顯示而不是預設字串。

列印將要列出的提交數量，並禁止所有其他輸出。當與 --left-right 一起使用時，則列印左右提交的數量，並用製表符分隔。當與 --cherry-mark 一起使用時，則從這些計數中省略補丁等價提交，並用製表符分隔等價提交的數量。