此鉤子由 git-am[1] 呼叫。它接受一個引數，即儲存建議的提交日誌訊息的檔名。以非零狀態退出將導致 git am 在應用補丁之前中止。

鉤子允許就地編輯訊息檔案，並可用於將訊息規範化為某些專案標準格式。它還可以用於在檢查訊息檔案後拒絕提交。

預設的 applypatch-msg 鉤子在啟用時會執行 commit-msg 鉤子（如果後者已啟用）。

此鉤子由 git-am[1] 呼叫。它不接受引數，並在應用補丁但提交之前被呼叫。

如果它以非零狀態退出，那麼在應用補丁後工作樹將不會被提交。

它可以用於檢查當前工作樹，並在不滿足某些測試時拒絕提交。

預設的 pre-applypatch 鉤子在啟用時會執行 pre-commit 鉤子（如果後者已啟用）。

此鉤子由 git-am[1] 呼叫。它不接受引數，並在應用補丁並提交之後被呼叫。

此鉤子主要用於通知，不能影響 git am 的結果。

此鉤子由 git-commit[1] 呼叫，並可透過 --no-verify 選項繞過。它不接受引數，並在獲取建議的提交日誌訊息和進行提交之前被呼叫。指令碼以非零狀態退出將導致 git commit 命令在建立提交之前中止。

預設的 pre-commit 鉤子在啟用時會捕獲引入的帶有尾隨空格的行，並在找到這樣的行時中止提交。

如果命令不會啟動編輯器來修改提交訊息，則所有 git commit 鉤子都會以環境變數 GIT_EDITOR=: 呼叫。

預設的 pre-commit 鉤子在啟用時（並且 hooks.allownonascii 配置選項未設定或設定為 false）會阻止使用非 ASCII 檔名。

此鉤子由 git-merge[1] 呼叫，並可透過 --no-verify 選項繞過。它不接受引數，並在合併成功執行後、在獲取建議的提交日誌訊息以進行提交之前被呼叫。指令碼以非零狀態退出將導致 git merge 命令在建立提交之前中止。

預設的 pre-merge-commit 鉤子在啟用時會執行 pre-commit 鉤子（如果後者已啟用）。

如果命令不會啟動編輯器來修改提交訊息，則此鉤子將以環境變數 GIT_EDITOR=: 呼叫。

如果合併無法自動進行，則需要單獨解決衝突並提交結果（請參閱 git-merge[1]）。此時，此鉤子不會執行，但 pre-commit 鉤子（如果已啟用）將會執行。

此鉤子由 git-commit[1] 在準備好預設日誌訊息後、在編輯器啟動之前呼叫。

它接受一個到三個引數。第一個是包含提交日誌訊息的檔名。第二個是提交訊息的來源，可以是：message（如果給出了 -m 或 -F 選項）；template（如果給出了 -t 選項或設定了 commit.template 配置選項）；merge（如果提交是合併或存在 .git/MERGE_MSG 檔案）；squash（如果存在 .git/SQUASH_MSG 檔案）；或 commit，後跟一個提交物件名稱（如果給出了 -c、-C 或 --amend 選項）。

如果退出狀態為非零，git commit 將中止。

此鉤子的目的是就地編輯訊息檔案，並且不會被 --no-verify 選項抑制。非零退出表示鉤子失敗並中止提交。它不應被用作 pre-commit 鉤子的替代品。

Git 附帶的示例 prepare-commit-msg 鉤子會刪除提交模板註釋部分中的幫助訊息。

此鉤子由 git-commit[1] 和 git-merge[1] 呼叫，並可透過 --no-verify 選項繞過。它接受一個引數，即儲存建議的提交日誌訊息的檔名。以非零狀態退出將導致命令中止。

鉤子允許就地編輯訊息檔案，並可用於將訊息規範化為某些專案標準格式。它還可以用於在檢查訊息檔案後拒絕提交。

預設的 commit-msg 鉤子在啟用時會檢測重複的 Signed-off-by 尾部，並在找到重複項時中止提交。

此鉤子由 git-commit[1] 呼叫。它不接受引數，並在提交完成後被呼叫。

此鉤子主要用於通知，不能影響 git commit 的結果。

此鉤子由 git-rebase[1] 呼叫，可用於阻止分支被 rebase。該鉤子可能帶有一個或兩個引數。第一個引數是系列從中分叉的上游。第二個引數是要 rebase 的分支，在 rebase 當前分支時未設定。

在 git-checkout[1] 或 git-switch[1] 在更新工作樹後執行時，會呼叫此鉤子。該鉤子接受三個引數：上一個 HEAD 的 ref、新的 HEAD 的 ref（可能已更改，也可能未更改），以及一個指示簽出是分支簽出（更改分支，flag=1）還是檔案簽出（從索引檢索檔案，flag=0）的標誌。此鉤子不能影響 git switch 或 git checkout 的結果，除了鉤子的退出狀態將成為這兩個命令的退出狀態。

在 git-clone[1] 之後也會執行此鉤子，除非使用了 --no-checkout （-n）選項。傳遞給鉤子的第一個引數是 null-ref，第二個是新 HEAD 的 ref，標誌始終為 1。對於 git worktree add 也是如此，除非使用了 --no-checkout。

此鉤子可用於執行倉庫有效性檢查、在不同時自動顯示與前一個 HEAD 的差異，或設定工作目錄元資料屬性。

此鉤子由 git-merge[1] 呼叫，當在本地倉庫上執行 git pull 時會發生。該鉤子接受一個引數，一個狀態標誌，指定正在進行的合併是否為 squash 合併。此鉤子不能影響 git merge 的結果，並且在合併因衝突而失敗時不會執行。

此鉤子可與相應的 pre-commit 鉤子結合使用，以儲存和恢復與工作樹關聯的任何形式的元資料（例如：許可權/所有權、ACL 等）。請參閱 contrib/hooks/setgitperms.perl 以獲取如何執行此操作的示例。

此鉤子由 git-push[1] 呼叫，可用於阻止推送發生。該鉤子帶有兩個引數，提供目標遠端的名稱和位置，如果未使用命名遠端，則兩個值將相同。

有關要推送的內容的資訊透過以下格式的行提供給鉤子的標準輸入

例如，如果運行了命令 git push origin master:foreign，則鉤子將收到類似以下的行

儘管會提供完整的物件名稱。如果 foreign ref 尚不存在，則 <remote-object-name> 將是全零物件名稱。如果要刪除 ref，則 <local-ref> 將提供為 (delete)，並且 <local-object-name> 將是全零物件名稱。如果本地提交是透過除可展開名稱（如 HEAD~ 或物件名稱）之外的內容指定的，則將按原始方式提供。

如果此鉤子以非零狀態退出，git push 將中止，不執行任何推送。有關拒絕推送的原因的資訊可以透過寫入標準錯誤來發送給使用者。

當 git-receive-pack[1] 響應 git push 並更新其倉庫中的引用時，會呼叫此鉤子。在開始更新遠端倉庫中的 ref 之前，會呼叫 pre-receive 鉤子。其退出狀態決定更新的成功或失敗。

此鉤子對每個接收操作執行一次。它不接受引數，但對於要更新的每個 ref，它會在標準輸入上接收一行格式如下：

其中 <old-oid> 是儲存在 ref 中的舊物件名稱，<new-oid> 是要儲存在新 ref 中的新物件名稱，<ref-name> 是 ref 的完整名稱。在建立新 ref 時，<old-oid> 是全零物件名稱。

如果鉤子以非零狀態退出，則不會更新任何 ref。如果鉤子以零狀態退出，更新仍然可以被 update 鉤子阻止。

標準輸出和標準錯誤輸出都會轉發到另一端的 git send-pack，因此您可以簡單地 echo 訊息給使用者。

可以透過環境變數 GIT_PUSH_OPTION_COUNT 讀取 git push --push-option=... 命令列的推送選項數量，選項本身位於 GIT_PUSH_OPTION_0、GIT_PUSH_OPTION_1、…​。如果協商不使用推送選項階段，則不會設定環境變數。如果客戶端選擇使用推送選項但未傳輸任何選項，則計數變數將設定為零，GIT_PUSH_OPTION_COUNT=0。

有關注意事項，請參閱 git-receive-pack[1] 中的“Quarantine Environment”部分。

當 git-receive-pack[1] 響應 git push 並更新其倉庫中的引用時，會呼叫此鉤子。在更新遠端倉庫中的 ref 之前，會呼叫 update 鉤子。其退出狀態決定 ref 更新的成功或失敗。

該鉤子對每個要更新的 ref 執行一次，並接受三個引數：

update 鉤子以零退出允許更新 ref。以非零狀態退出將阻止 git receive-pack 更新該 ref。

此鉤子可用於透過確保物件名稱是現有物件名稱所指向提交物件的後代提交物件來防止對某些 ref 進行*強制*更新。也就是說，強制執行“僅限快進”策略。

它還可以用於記錄舊..新狀態。但是，它不知道所有分支的集合，因此在天真使用時，最終會為每個 ref 傳送一封電子郵件。 post-receive 鉤子更適合此目的。

在限制使用者僅透過網路訪問 git 命令的環境中，此鉤子可用於實現訪問控制，而無需依賴檔案系統所有權和組 membership。請參閱 git-shell[1] 瞭解如何使用登入 shell 將使用者的訪問許可權限制為僅 git 命令。

標準輸出和標準錯誤輸出都會轉發到另一端的 git send-pack，因此您可以簡單地 echo 訊息給使用者。

預設的 update 鉤子在啟用時（並且 hooks.allowunannotated 配置選項未設定或設定為 false）會阻止推送未註解的標籤。

此鉤子由 git-receive-pack[1] 呼叫。如果伺服器設定了多值配置變數 receive.procReceiveRefs，並且傳送到 receive-pack 的命令具有匹配的引用名稱，則這些命令將由此鉤子執行，而不是由內部 execute_commands() 函式執行。此鉤子負責更新相關引用並將結果報告回 receive-pack。

此鉤子對每個接收操作執行一次。它不接受引數，但使用 pkt-line 格式協議與 receive-pack 通訊，以讀取命令、推送選項併發送結果。在下面的協議示例中，字母 S 代表 receive-pack，字母 H 代表此鉤子。

proc-receive 鉤子的每個命令可能指向一個偽引用，並且始終將零舊值作為其 old-oid，而 proc-receive 鉤子可以更新一個備用引用，並且該備用引用可能已存在一個非零 old-oid。對於這種情況，此鉤子將使用“option”指令來報告由前導“ok”指令給出的引用的擴充套件屬性。

此鉤子命令的報告應與輸入順序相同。proc-receive 鉤子的退出狀態僅決定傳送給它的命令組的成功或失敗，除非使用原子推送。

當 git-receive-pack[1] 響應 git push 並更新其倉庫中的引用時，會呼叫此鉤子。在處理完所有建議的 ref 更新後，如果至少有一個 ref 已更新，則此鉤子將在遠端倉庫上執行一次。

該鉤子不接受引數。對於每個成功更新的 ref，它會在標準輸入上接收一行，格式與 pre-receive 鉤子相同。

此鉤子不會影響 git receive-pack 的結果，因為它在實際工作完成後被呼叫。

它取代了 post-update 鉤子，因為它除了 ref 名稱外，還可以獲取所有 ref 的舊值和新值。

標準輸出和標準錯誤輸出都會轉發到另一端的 git send-pack，因此您可以簡單地 echo 訊息給使用者。

預設的 post-receive 鉤子是空的，但在 Git 發行版的 contrib/hooks 目錄中提供了一個示例指令碼 post-receive-email，該指令碼實現了傳送提交電子郵件的功能。

可以透過環境變數 GIT_PUSH_OPTION_COUNT 讀取 git push --push-option=... 命令列的推送選項數量，選項本身位於 GIT_PUSH_OPTION_0、GIT_PUSH_OPTION_1、…​。如果協商不使用推送選項階段，則不會設定環境變數。如果客戶端選擇使用推送選項但未傳輸任何選項，則計數變數將設定為零，GIT_PUSH_OPTION_COUNT=0。

有關其他詳細資訊，請參閱 git-receive-pack[1] 中的“post-receive”部分。

當 git-receive-pack[1] 響應 git push 並更新其倉庫中的引用時，會呼叫此鉤子。它在所有 ref 更新完成後在遠端倉庫上執行一次。

它接受可變數量的引數，每個引數是要更新的 ref 的名稱。

此鉤子主要用於通知，不能影響 git receive-pack 的結果。

post-update 鉤子可以知道哪些 head 被推送了，但它不知道它們的原始值和更新值，所以它不適合用於記錄舊..新。如果您需要它們，可以考慮使用 post-receive 鉤子。

啟用後，預設的 post-update 鉤子會執行 git update-server-info 以保持用於啞傳輸（例如 HTTP）的資訊是最新的。如果您釋出了一個可以透過 HTTP 訪問的 Git 倉庫，您應該啟用此鉤子。

標準輸出和標準錯誤輸出都會轉發到另一端的 git send-pack，因此您可以簡單地 echo 訊息給使用者。

此鉤子由執行引用更新的任何 Git 命令呼叫。它在引用事務準備、提交或中止時執行，因此可能會被呼叫多次。該鉤子還支援符號引用更新。

該鉤子接受一個引數，即給定引用事務所處的當前狀態：

對於新增到事務中的每個引用更新，鉤子將在標準輸入上接收一行格式如下：

其中 <old-value> 是傳遞到引用事務中的舊物件名稱，<new-value> 是要儲存在 ref 中的新物件名稱，<ref-name> 是 ref 的完整名稱。在強制更新引用而不考慮其當前值時，或當引用需要重新建立時，<old-value> 是全零物件名稱。為了區分這些情況，您可以透過 git rev-parse 檢查 <ref-name> 的當前值。

對於符號引用更新，<old_value> 和 <new-value> 欄位可以表示引用而不是物件。引用將以 ref: 字首表示，例如 ref:<ref-target>。

除了“prepared”狀態外，鉤子的退出狀態在任何狀態下都被忽略。在“prepared”狀態下，非零退出狀態將導致事務被中止。在這種情況下，鉤子不會以“aborted”狀態被呼叫。

當 git-receive-pack[1] 響應 git push 並更新其倉庫中的引用時，並且當推送嘗試更新當前已簽出的分支且 receive.denyCurrentBranch 配置變數設定為 updateInstead 時，會呼叫此鉤子。預設情況下，如果遠端倉庫的工作樹和索引與當前已簽出的提交有任何差異，則拒絕此類推送；當工作樹和索引都與當前提交匹配時，它們將被更新以匹配分支的最新推送。此鉤子用於覆蓋預設行為。

該鉤子接收將用於更新當前分支尖端的提交。它可以以非零狀態退出以拒絕推送（當它這樣做時，它不得修改索引或工作樹）。或者，它可以對工作樹和索引進行任何必要的更改，以將它們帶到當前分支的尖端更新到新提交時的所需狀態，並以零狀態退出。

例如，鉤子可以簡單地執行 git read-tree -u -m HEAD "$1" 來模擬反向執行的 git fetch 與 git push，因為 git read-tree -u -m 的雙樹形式本質上與 git switch 或 git checkout 切換分支同時保留本地更改（這些更改不會干擾分支之間的差異）相同。

此鉤子由 git gc --auto 呼叫（請參閱 git-gc[1]）。它不接受引數，指令碼以非零狀態退出將導致 git gc --auto 中止。

此鉤子由重寫提交的命令呼叫（git-commit[1] 當使用 --amend 和 git-rebase[1] 呼叫時；然而，完整的歷史（重）寫工具，如 git-fast-import[1] 或 git-filter-repo，通常不會呼叫它！）。其第一個引數表示呼叫它的命令：目前是 amend 或 rebase。未來可能會傳遞其他依賴於命令的引數。

該鉤子在標準輸入上接收重寫提交的列表，格式如下：

extra-info 再次依賴於命令。如果為空，則前面的空格也將被省略。目前，沒有命令傳遞任何 extra-info。

該鉤子總是在自動註釋複製（請參閱 git-config[1] 中的 "notes.rewrite.<command>"）之後執行，因此可以訪問這些註釋。

以下命令特定註釋適用：

此鉤子由 git-send-email[1] 呼叫。

它接受這些命令列引數。它們是：1.儲存要傳送的電子郵件內容的檔案的名稱。2.儲存電子郵件 SMTP 頭的檔案的名稱。

SMTP 頭以與傳遞給使用者的郵件傳輸代理 (MTA) 完全相同的方式傳遞。實際上，傳遞給使用者 MTA 的電子郵件是 $2 的內容後跟 $1 的內容。

下面顯示了一些常見頭的示例。請注意大小寫和多行製表符結構。

以非零狀態退出將導致 git send-email 在傳送任何電子郵件之前中止。

執行鉤子時會設定以下環境變數。

這些變數可以用於驗證補丁系列。

Git 附帶的示例 sendemail-validate 鉤子會檢查所有傳送的補丁（不包括封面信）是否可以在不發生衝突的情況下應用到上游倉庫的預設分支之上。為在應用給定系列的所有補丁後執行其他驗證步驟留出了一些佔位符。

當配置選項 core.fsmonitor 設定為 .git/hooks/fsmonitor-watchman 或 .git/hooks/fsmonitor-watchmanv2（取決於鉤子版本）時，會呼叫此鉤子。

版本 1 接受兩個引數：版本號 (1) 和自 1970 年 1 月 1 日午夜以來的經過的納秒數。

版本 2 接受兩個引數：版本號 (2) 和用於標識自該標記以來的更改的令牌。對於 watchman，這將是時鐘 ID。此版本必須在標準輸出上輸出新的令牌，然後是一個 NUL，然後是檔案列表。

該鉤子應在標準輸出上輸出自請求時間以來可能已更改的所有工作目錄中檔案的列表。邏輯應該是包含性的，以免錯過任何潛在的更改。路徑應相對於工作目錄的根，並由單個 NUL 分隔。

包含實際上未更改的檔案是可以的。應包含所有更改，包括新建立和刪除的檔案。重新命名檔案時，應同時包含舊名稱和新名稱。

Git 將限制它檢查更改的檔案以及檢查未跟蹤檔案的目錄，這取決於路徑名。

告訴 git“所有檔案都已更改”的一種最佳化方法是返回檔名 /。

退出狀態決定 Git 是否會使用鉤子中的資料來限制其搜尋。發生錯誤時，它將回退到驗證所有檔案和資料夾。

此鉤子由 git-p4 submit 呼叫。

p4-changelist 鉤子在使用者編輯了 changelist 訊息後執行。它可以透過 --no-verify 選項繞過。它接受一個引數，即儲存建議的 changelist 文字的檔名。以非零狀態退出將導致命令中止。

鉤子允許編輯 changelist 檔案，並可用於將文字規範化為某些專案標準格式。它還可以用於在檢查訊息檔案後拒絕提交。

有關詳細資訊，請執行 git-p4 submit --help。

此鉤子由 git-p4 submit 呼叫。

p4-prepare-changelist 鉤子在準備好預設 changelist 訊息後、在編輯器啟動之前執行。它接受一個引數，即包含 changelist 文字的檔名。指令碼以非零狀態退出將中止程序。

鉤子的目的是就地編輯訊息檔案，並且不會被 --no-verify 選項抑制。即使設定了 --prepare-p4-only，也會呼叫此鉤子。

有關詳細資訊，請執行 git-p4 submit --help。

此鉤子由 git-p4 submit 呼叫。

p4-post-changelist 鉤子在 P4 中的提交成功後呼叫。它不接受引數，主要用於通知，不能影響 git p4 submit 操作的結果。

有關詳細資訊，請執行 git-p4 submit --help。

此鉤子由 git-p4 submit 呼叫。它不接受任何引數，也不從標準輸入讀取任何內容。指令碼以非零狀態退出將阻止 git-p4 submit 的啟動。可以使用 --no-verify 命令列選項繞過它。執行 git-p4 submit --help 獲取詳細資訊。

在 read-cache.c 的 do_write_locked_index 中寫入索引時呼叫此鉤子。

傳遞給鉤子的第一個引數是正在更新的工作目錄的指示符。“1”表示工作目錄已更新，“0”表示工作目錄未更新。

傳遞給鉤子的第二個引數是索引是否已更新以及 skip-worktree 位是否可能已更改的指示符。“1”表示 skip-worktree 位可能已更新，“0”表示它們未更新。

鉤子執行時，只有一個引數應設定為“1”。鉤子執行時傳遞“1”、“1”是不可能的。