作为推送操作目标的“远程”仓库。该参数可以是 URL（参见下文 GIT URLS 部分）或远程仓库的名称（参见下文 REMOTES 部分）。

指定用哪个源对象更新哪个目标引用。

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

删除没有本地对应分支的远程分支。例如，如果同名的本地分支不再存在，远程分支 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，则这是默认行为。

执行所有操作，但实际上不发送更新。

生成机器可读的输出。每个引用的输出状态行将以制表符分隔，并发送到标准输出（stdout）而不是标准错误（stderr）。将给出引用的完整符号名称。

所有列出的引用都将从远程仓库中删除。这与在所有引用前加冒号的效果相同。

除了命令行中显式列出的引用规格外，推送 refs/tags 下的所有引用。

推送所有在没有此选项时也会被推送的引用，同时推送 refs/tags 中远程仓库缺失但指向正在推送的引用可达的“commit-ish”对象的附注标签。这也可以通过配置变量 push.followTags 指定。更多信息请参见 git-config[1] 中的 push.followTags。

对更新接收端引用的推送请求进行 GPG 签名，以便让钩子检查和/或记录。可能的值为：

如果可用，在远程端使用原子事务。要么更新所有引用，要么在出错时不更新任何引用。如果服务器不支持原子推送，则推送将失败。

将给定的字符串传输到服务器，服务器会将其传递给 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。此标志即使在标准错误流未定向到终端时也会强制显示进度状态。

可用于确保要推送的修订版本所使用的所有子模块提交在远程跟踪分支上都可用。可能的值为：

切换 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 分支。这种形式仅在本地名称和远程名称不同时，才需要在远程仓库中创建新分支或标签；否则，引用名称本身即可工作。

在 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 应采取的操作。不同的值适用于特定的工作流程；例如，在纯粹的中央工作流中（即获取源等于推送目的地），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 的行为就像该变量的每个 <option> 都作为 --push-option=<option> 给出一样。

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，则尝试通过多轮协商来减小发送的包文件大小，在协商中客户端和服务器尝试查找共同的提交。如果为 false，Git 将完全依赖服务器的引用公告来查找共同提交。

如果设置为 false，即使 pack.useBitmaps 为 true，也会在 git push 中禁用位图，但不妨碍其他 git 操作使用位图。默认值为 true。