Git推送时提示master分支已重命名为main但无main分支如何解决？

该提示是GitHub服务端返回的，不是本地Git报错，核心原因是GitHub仓库的分支配置中存在未完成的master→main重命名规则，或者默认分支设置和实际推送分支不匹配，和本地/远端是否存在main分支没有直接关系，可按以下步骤排查修复：

1. 修改GitHub仓库端分支配置 #

登录对应GitHub仓库的管理后台，进入「Settings」→「Branches」设置页：

• 确认「Default branch」字段值为master，如果显示为main直接修改为master并保存
• 找到「Default branch rename」相关配置项，如果存在未完成的重命名引导流程，直接取消该流程即可清除提示

如果你是仓库协作者而非管理员，需要联系仓库管理员完成上述配置修改，本地操作无法解决服务端返回的提示。

2. 清理本地远程分支缓存 #

本地存储的远程分支元数据过期也可能触发异常提示，执行以下命令同步远端分支信息：

git fetch origin --prune

3. 修正本地分支推送规则 #

检查本地master分支的推送配置是否正确：

• 执行git config branch.master.pushRemote，如果输出不是origin，执行以下命令绑定上游：

git config branch.master.pushRemote origin

• 检查全局推送默认规则，执行git config --global push.default，如果输出不是simple或current，可修改为按当前分支名推送：

git config --global push.default current

4. 同步远端分支引用 #

上述配置修改完成后，拉取远端最新代码后重新推送即可：

git pull origin master
git push origin master

内容的提问来源于stack exchange，提问作者Dennis