Git推送main分支至GitHub时出现Failed to push some refs错误求助

错误原因 #

你在GitHub创建仓库时，大概率勾选了生成README、LICENSE或.gitignore这类初始化文件，导致远程仓库的main分支已经存在提交记录。而你本地的main分支是刚git init出来的空分支，两者没有共同的提交历史，Git会拒绝直接推送。

解决方法 #

情况1：远程仓库已有内容（如README）

先拉取远程内容并合并本地分支（允许无共同历史的合并）：

git pull origin main --allow-unrelated-histories

如果拉取过程中出现文件冲突，手动修改冲突文件后，执行提交：

git add .
git commit -m "Merge remote main branch"

最后再推送：

git push -u origin main

情况2：远程仓库是空的（创建时未生成任何文件）

你本地分支还没有任何提交记录，Git不允许推送空分支。先创建初始提交：

touch README.md
git add README.md
git commit -m "Initial commit"
git push -u origin main

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