Git 如何设置默认推送当前分支而非 matching？

直接修改 Git 配置中的 push.default 选项为 simple 或 current，即可实现只推送当前分支，避免 Git 2.0 之前 matching 模式可能带来的误推送风险。

先说结论：建议将配置改为 simple，这是 Git 2.0 之后的默认行为，比 matching 更安全。

命令速用版

如果你希望全局生效，直接在终端执行以下命令：

git config `--global` push.default simple

如果只想针对当前仓库生效，去掉 `--global` 参数即可。

在 Git 2.0 版本之前，push.default 的默认值是 matching。这种模式下，当你执行 git push 而不指定分支时，Git 会尝试推送所有本地分支到远程同名分支。如果本地有多个分支且命名与远程重合，可能会意外推送未准备好的代码。

从 Git 2.0 开始，默认值变更为 simple。这种模式只推送当前分支到同名的远程分支，且要求远程分支名称一致，否则拒绝推送。这更符合大多数人的直觉，也能减少误操作。

1. 检查 Git 版本

确保你的 Git 版本支持该配置，虽然老版本也支持手动设置，但 2.0 以上默认行为已变更。

git `--version`

2. 查看当前配置

确认当前 push.default 的值是什么。

git config push.default

如果输出为空，说明使用的是系统默认值；如果输出 matching，则存在误推送风险。

3. 修改配置

执行速用版中的命令，将值设为 simple。

4. 设置上游分支（可选但推荐）

为了简化后续推送，建议将当前分支与远程分支关联。使用 HEAD 可自动指向当前分支，无需手动输入分支名。

git push -u origin HEAD

若需确认当前分支名称，可执行：

git rev-parse `--abbrev-ref` HEAD

1. 再次检查配置

git config push.default

输出应为 simple。

2. 执行推送测试

在仓库中执行 git push，观察输出日志。如果使用 -v 参数，可以看到更详细的引用更新信息。

git push -v

确认日志中只涉及当前分支的更新，没有提及其它分支。若分支名不一致，simple 模式会报错拒绝推送。

1. 旧版本 Git 环境

在非常旧的服务器或 CI 环境中，Git 版本可能低于 2.0，此时默认行为仍是 matching。建议在这些环境中显式配置 push.default。

2. 分支名称不一致

simple 模式要求本地分支名与远程分支名一致。如果本地叫 feature-a，远程叫 origin/feature-dev，simple 模式会拒绝推送。此时需使用 current 模式或显式指定分支映射。

3. 多远程仓库场景

如果一个本地仓库关联了多个远程仓库，推送时需指定远程名称，否则可能推送到错误的远程地址。