作為推送操作目的地的“遠端”倉庫。此引數可以是 URL（參見下面的 GIT URL 部分）或遠端名稱（參見下面的 遠端 部分）。

指定用哪個源物件更新哪個目標引用。<引用規範> 引數的格式是可選的加號 +，後跟源物件 <src>，再跟冒號 :，最後跟目標引用 <dst>。

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

刪除沒有本地對應分支的遠端分支。例如，如果同名的本地分支不再存在，則遠端分支 tmp 將被刪除。這也遵循引用規範，例如 git push --prune remote refs/heads/*:refs/tmp/* 將確保如果 refs/heads/foo 不存在，則遠端 refs/tmp/foo 將被刪除。

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

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

生成機器可讀的輸出。每個引用的輸出狀態行將以製表符分隔，併發送到標準輸出而非標準錯誤。將給出引用的完整符號名稱。

所有列出的引用都將從遠端倉庫中刪除。這與在所有引用前加上冒號的效果相同。

除了命令列中明確列出的引用規範外，refs/tags 下的所有引用都將被推送。

推送所有在沒有此選項時會被推送的引用，並且還推送遠端端缺失但指向從被推送引用可達的提交物件的 refs/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

通常，該命令會拒絕更新不是用於覆蓋它的本地引用的祖先的遠端引用。此外，當使用 --force-with-lease 選項時，如果遠端引用的當前值與期望值不匹配，則該命令會拒絕更新該遠端引用。

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

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

對於每個已是最新或已成功推送的分支，新增上游（跟蹤）引用，該引用被無引數的 git-pull[1] 和其他命令使用。有關詳細資訊，請參見 git-config[1] 中的 branch.<name>.merge。

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

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

執行詳細模式。

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

可用於確保要推送的修訂版所使用的所有子模組提交都在遠端跟蹤分支上可用。如果使用 *check*，Git 將驗證要推送的修訂版中更改的所有子模組提交在子模組的至少一個遠端上可用。如果缺少任何提交，推送將中止並以非零狀態退出。如果使用 *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 <遠端倉庫>，其中 <遠端倉庫> 是當前分支的遠端倉庫（如果當前分支未配置遠端倉庫，則為 origin）。

如果沒有額外的配置，如果當前分支的名稱與配置的上游分支（branch.<name>.merge 配置變數）相同，則將當前分支推送到配置的上游分支，否則會報錯而不進行推送。

推送“匹配”分支到 origin。有關“匹配”分支的描述，請參見上面 選項 部分中的 <引用規範>。

在源倉庫中找到與 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。當本地名稱與遠端名稱不同時，才需要此形式在遠端倉庫中建立新分支或標籤；否則，單獨的引用名稱即可。

在 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* 的行為），並且還希望設定上游跟蹤，則此功能很有用。最可能受益於此選項的工作流程是所有分支都預期在遠端上具有相同名稱的*簡單*集中式工作流程。

定義了在未給定引用規範（無論是來自命令列、配置或其他地方）時 git push 應採取的操作。不同的值適用於特定的工作流程；例如，在純粹的集中式工作流程中（即抓取源等於推送目的地），upstream 可能就是您想要的。可能的值有

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

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

當命令列中沒有給出 --push-option=<option> 引數時，git push 的行為如同此變數的每個 <值> 都被作為 --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 將僅依賴伺服器的引用通告來尋找共同提交。

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