推送操作的目標“遠端倉庫”。此引數可以是 URL（請參閱下面的 Git URLS 部分）或遠端倉庫的名稱（請參閱下面的 遠端倉庫 部分）。

指定用什麼源物件更新什麼目標引用。

推送所有分支（即 refs/heads/ 下的引用）；不能與其他 <refspec> 一起使用。

刪除沒有本地對應項的遠端分支。例如，如果名為 tmp 的本地分支不再存在，則遠端分支 tmp 將被刪除。這也尊重 refspec，例如 git push --prune remote refs/heads/*:refs/tmp/* 將確保如果 refs/heads/foo 不存在，遠端的 refs/tmp/foo 將被刪除。

不指定要推送的每個引用，而是指定將 refs/ 下的所有引用（包括但不限於 refs/heads/、refs/remotes/ 和 refs/tags/）映象到遠端倉庫。新建立的本地引用將推送到遠端端，本地更新的引用將在遠端端強制更新，刪除的引用將從遠端端移除。如果配置選項 remote.<remote>.mirror 被設定，則這是預設行為。

執行所有操作，但實際上不傳送更新。

生成機器可讀的輸出。每條引用（ref）的狀態輸出行將以製表符分隔併發送到 stdout 而不是 stderr。將給出引用的完整符號名稱。

所有列出的引用都將從遠端倉庫中刪除。這相當於在所有引用前面加上冒號。

除了在命令列中明確列出的 refspec 外，還將推送 refs/tags 下的所有引用。

推送沒有此選項時會推送的所有引用，還會推送遠端倉庫中缺失但指向可達於正在推送的引用（ref-ish）的帶註釋的標籤（annotated tags）。這也可以透過配置變數 push.followTags 指定。有關更多資訊，請參閱 git-config[1] 中 push.followTags 的說明。

GPG 對推送請求進行簽名，以更新接收端的引用，從而允許鉤子檢查和/或記錄。如果設定為 false 或 --no-signed，則不嘗試簽名。如果設定為 true 或 --signed，則伺服器不支援簽名推送時，推送將失敗。如果設定為 if-asked，則僅當伺服器支援簽名推送時才進行簽名。如果實際呼叫 gpg --sign 失敗，推送也將失敗。有關接收端細節，請參閱 git-receive-pack[1]。

如果可用，則在遠端端使用原子事務。要麼所有引用都得到更新，要麼在發生錯誤時，沒有任何引用得到更新。如果伺服器不支援原子推送，推送將失敗。

將給定字串傳送到伺服器，伺服器會將其傳遞給 pre-receive 和 post-receive 鉤子。給定字串不能包含 NUL 或 LF 字元。當給出多個 --push-option=<option> 時，它們將按命令列中列出的順序全部發送到另一端。當命令列中未給出 --push-option=<option> 時，將使用 push.pushOption 配置變數的值。

遠端端的 git-receive-pack 程式的路徑。當透過 ssh 推送到遠端倉庫，並且該程式不在預設 $PATH 的目錄中時，有時會很有用。

通常，“git push”會拒絕更新不是用於覆蓋它的本地引用的祖先的遠端引用。

git remote add origin-push $(git config remote.origin.url)
git fetch origin-push

git push --force-with-lease origin-push

git fetch              # update 'master' from remote
git tag base master    # mark our base point
git rebase -i master   # rewrite some commits
git push --force-with-lease=master:base master:master

通常，git push 會拒絕更新不是被推送提交的祖先的分支。

僅當遠端跟蹤引用的尖端已在本地整合時，才強制更新。

此選項等同於 <repository> 引數。如果兩者都指定，則命令列引數具有優先權。

對於每個更新或成功推送的分支，新增上游（跟蹤）引用，用於無引數的 git-pull[1] 和其他命令。有關更多資訊，請參閱 git-config[1] 中 branch.<name>.merge 的說明。

這些選項被傳遞給 git-send-pack[1]。當傳送方和接收方共享許多相同的物件時，薄傳輸（thin transfer）會顯著減少傳送的資料量。預設是 --thin。

抑制所有輸出，包括更新的引用的列表，除非發生錯誤。進度不會報告到標準錯誤流。

執行詳細模式。

預設情況下，當標準錯誤流連線到終端時，會報告進度狀態，除非指定了 -q。此標誌強制報告進度狀態，即使標準錯誤流未定向到終端。

可用於確保要推送的修訂版本所使用的所有子模組提交都存在於遠端跟蹤分支上。如果使用 check，Git 將驗證要推送的修訂版本中更改的所有子模組提交是否至少存在於子模組的一個遠端倉庫上。如果缺少任何提交，推送將被中止並以非零狀態退出。如果使用 on-demand，則將推送所有在要推送的修訂版本中更改的子模組。如果 on-demand 無法推送所有必需的修訂版本，它也將被中止並以非零狀態退出。如果使用 only，則推送所有子模組，而超專案保持未推送。使用 no 或 --no-recurse-submodules 可以覆蓋 push.recurseSubmodules 配置變數，當不需要子模組遞迴時。

切換 pre-push 鉤子（請參閱 githooks[5]）。預設是 --verify，給鉤子一個阻止推送的機會。使用 --no-verify 時，鉤子將被完全繞過。

僅使用 IPv4 地址，忽略 IPv6 地址。

僅使用 IPv6 地址，忽略 IPv4 地址。

一個字元，表示引用的狀態

對於成功推送的引用，摘要顯示了引用的舊值和新值，格式適用於作為 git log 的引數（大多數情況下是 <old>..<new>，對於強制的非快進更新是 <old>...<new>）。

正在推送的本地引用的名稱，減去其 refs/<type>/ 字首。在刪除的情況下，本地引用的名稱被省略。

正在更新的遠端引用的名稱，減去其 refs/<type>/ 字首。

可讀的解釋。對於成功推送的引用，不需要解釋。對於失敗的引用，會描述失敗的原因。

工作方式類似於 git push <remote>，其中 <remote> 是當前分支的遠端（或 origin，如果當前分支沒有配置遠端）。

在沒有額外配置的情況下，將當前分支推送到配置的上游（branch.<name>.merge 配置變數），前提是它與當前分支同名，否則會報錯而不推送。

將“匹配”的分支推送到 origin。有關“匹配”分支的描述，請參見上文 OPTIONS 部分中的 <refspec>。

在源儲存庫中查詢與 master 匹配的引用（最有可能找到 refs/heads/master），並使用它更新 origin 儲存庫中的同一引用（例如 refs/heads/master）。如果 master 在遠端不存在，則會建立它。

將當前分支推送到遠端同名分支的便捷方法。

使用與 master 匹配的源引用（例如 refs/heads/master）來更新 mothership 儲存庫中與 satellite/master 匹配的引用（最可能是 refs/remotes/satellite/master）；對 dev 和 satellite/dev 執行相同的操作。

將當前分支推送到 origin 儲存庫中與 master 匹配的遠端引用。這種形式便於推送當前分支，而不必考慮其本地名稱。

透過複製當前的 master 分支，在 origin 儲存庫中建立 experimental 分支。僅當本地名稱和遠端名稱不同時，才需要此形式來建立遠端儲存庫中的新分支或標籤；否則，僅使用 ref 名稱即可。

在 origin 儲存庫中查詢與 experimental 匹配的引用（例如 refs/heads/experimental），並刪除它。

使用 dev 分支更新 origin 儲存庫的 master 分支，允許非快進更新。這可能會在 origin 儲存庫中留下未引用的提交。考慮以下情況，其中無法進行快進更新：

	    o---o---o---A---B  origin/master
		     \
		      X---Y---Z  dev

		      A---B  (unnamed branch)
		     /
	    o---o---o---X---Y---Z  master

如果設定為“true”，則在當前分支沒有上游跟蹤時，預設推送假定為 --set-upstream；此選項在 push.default 選項simple、upstream和current時生效。如果您希望新分支預設推送到預設遠端（如push.default=current的行為），並且還希望設定上游跟蹤，那麼此選項非常有用。最有可能受益於此選項的工作流程是simple中心化工作流程，其中所有分支都應在遠端具有相同的名稱。

定義 git push 在沒有給出 refspec（無論是來自命令列、配置還是其他地方）時應執行的操作。不同的值適用於特定的工作流程；例如，在純粹的中心化工作流程（即 fetch 源等於 push 目標）中，upstream 可能是您想要的。可能的值有：

如果設定為 true，則預設啟用 --follow-tags 選項。您可以透過指定 --no-follow-tags 在推送時覆蓋此配置。

可以設定為布林值，或字串if-asked。true 值會導致所有推送都經過 GPG 簽名，如同將 --signed 傳遞給 git-push[1]。字串if-asked會導致在伺服器支援的情況下對推送進行簽名，如同將 --signed=if-asked 傳遞給git push。false 值可能會覆蓋較低優先順序配置檔案中的值。顯式的命令列標誌始終覆蓋此配置選項。

當命令列為給出 --push-option=<option> 引數時，git push 的行為就像將該變數的每個 <value> 作為 --push-option=<value> 一樣。

Example:

/etc/gitconfig
  push.pushoption = a
  push.pushoption = b

~/.gitconfig
  push.pushoption = c

repo/.git/config
  push.pushoption =
  push.pushoption = b

This will result in only b (a and c are cleared).

可以是“check”、“on-demand”、“only”或“no”，其行為與“push --recurse-submodules”相同。如果未設定，則預設使用no，除非設定了submodule.recurse（在這種情況下，true值表示on-demand）。

如果設定為“true”，則等同於在命令列中將 --force-if-includes 指定為 git-push[1] 的選項。在推送時新增 --no-force-if-includes 會覆蓋此配置設定。

如果設定為“true”，則嘗試透過客戶端和伺服器之間嘗試查詢共同提交的協商輪次來減小發送的 packfile 的大小。如果設定為“false”，Git 將僅依賴伺服器的 ref 廣告來查詢共同提交。

如果設定為“false”，則停用“git push”使用點陣圖，即使 pack.useBitmaps 為“true”，但不會阻止其他 git 操作使用點陣圖。預設為 true。