git push origin main报错src refspec main does not match any原因是什么？

问题根因 #

git push 命令中，如果你采用 git push <远程仓库名> <本地分支名>:<远程分支名> 的缩写格式 git push <远程仓库名> <分支名> 时，Git 会默认将其解析为把本地同名分支推送到远程对应分支，你遇到报错的核心原因是：

• 你本地不存在名为 main 的分支，你当前的本地分支名为 master，所以执行 git push -u origin main 时，Git 找不到本地名为 main 的引用（refspec），就会抛出 src refspec main does not match any 的错误。
• 而使用 git push -u origin HEAD:main 时，HEAD 指向你当前已经检出的活动分支（也就是本地的 master 分支），Git 可以正常找到对应的本地引用，自然可以正常推送到远程的 main 分支。

另外你提前给本地 master 分支设置上游为 origin/main 的配置，仅对不带参数的 git pull、git push 这类命令生效，你显式指定分支名执行 push 时，不会用到该预设配置，依然会按你输入的分支名匹配本地引用。

简化推送的解决方案 #

• 如果要保留本地 master 分支名，只需执行一次 git push -u origin master:main 完成上游绑定，后续你在 master 分支上直接执行 git push 即可正常推送，不需要再加任何参数。
• 如果要和远程分支名对齐避免混淆，可以先把本地 master 分支重命名为 main：git branch -M main，之后就可以直接用 git push -u origin main 正常推送。

内容的提问来源于stack exchange，提问作者35_Khushal Makhija