使用QtCreator与Git(GitHub)时分支名称不匹配问题求助

报错原因 #

你当前本地的development分支，其关联的上游远程分支被设置成了main，而非同名的origin/development。直接执行git push时，Git默认会推到当前分支的上游分支，但上游分支名和本地分支名不匹配，因此触发报错。

而你在QtCreator右键development分支执行push能成功，是因为QtCreator明确指定了要推送到远程的development分支，绕开了默认上游分支的逻辑。

快速临时解决 #

如果只是想把当前本地development分支推送到远程的development分支，直接执行：

git push origin development

永久解决（推荐） #

把本地development分支的上游分支设置为远程的origin/development，这样以后直接执行git push就会默认推到正确的远程分支：

git branch --set-upstream-to=origin/development development
# 或者第一次推送时用-u参数自动设置上游
git push -u origin development

你可以先执行git branch -vv命令，查看本地分支与上游分支的关联情况，确认设置是否生效。

避免后续同类问题 #

配置Git的push.default为simple，这样Git会默认推送到与本地分支同名的远程分支，且仅当分支名匹配时才自动配置上游分支，符合常规使用习惯：

git config --global push.default simple

报错信息关键术语解释 #

• HEAD：Git的指针，指向你当前所在的本地分支（这里就是development）
• 上游分支（upstream）：本地分支关联的远程分支，用于git push/git pull的默认目标
• origin：你克隆的远程仓库的默认别名

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