如何解决上传本地项目到Git仓库时src refspec main不匹配报错

错误根源 #

这个报错的核心原因是你本地的main分支没有任何提交记录——从压缩包解压的项目只是存在文件，但还没被Git追踪并生成提交，Git不允许推送空分支到远程仓库，和用HTTPS还是SSH地址无关。

修复步骤 #

• 先把项目所有文件加入Git暂存区：

  git add .
  

  要是有不需要Git追踪的文件，先在项目根目录建.gitignore文件，把要排除的内容写进去再执行上述命令。
• 提交暂存区的文件到本地分支：

  git commit -m "初始化项目"
  

  引号里的提交信息可以根据你的需求修改，比如“first commit”或者其他描述。
• 重新执行推送命令：

  git push -uf origin main
  

可选排查步骤 #

如果执行后仍有问题，可以先确认以下信息：

• 查看本地所有分支：git branch -a
• 检查远程仓库关联状态：git remote -v
• 确认本地提交记录：git log

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