使用Sandbox提交Git代码遇错误：src refspec refs/heads/master不匹配

问题根源 #

你遇到的问题大概率是以下两种情况之一：

1. 克隆的远程Sandbox仓库是空仓库（无任何初始提交记录），本地也未创建对应分支；
2. 远程仓库的默认分支不是master（当前GitHub等平台默认分支多为main），你用错误的分支名执行操作。

具体解决步骤 #

第一步：确认仓库基础状态

先执行以下命令排查核心信息：

• 检查本地暂存文件状态：git status
• 确认远程仓库地址正确：git remote -v
• 查看远程仓库的默认分支：git remote show origin（输出里会标注HEAD branch）

第二步：分情况处理

情况1：远程仓库是空仓库（无任何提交）

如果远程仓库还没有任何提交记录，直接执行：

1. 提交本地暂存文件：git commit -m "My first commit"
2. 推送并关联远程分支（替换为远程默认分支名，比如main或master）：

   git push -u origin main
   # 若远程默认分支是master则执行：
   git push -u origin master
   

   推送后远程会自动创建对应分支，后续操作即可正常进行。

情况2：远程仓库已有分支，但本地未拉取

如果远程仓库存在分支，但本地git branch -a看不到，先拉取所有远程分支数据：

1. 拉取远程全部分支信息：git fetch origin
2. 查看远程分支列表：git branch -r（此时应该能看到远程分支）
3. 切换到目标远程分支（比如远程分支是dev）：

   git checkout dev
   # 新版Git可使用：
   git switch dev
   

4. 若你已完成本地提交，将本地提交合并到当前分支：git merge HEAD（如有冲突需手动解决）
5. 最后推送更新：git push origin dev

额外提示

目前主流代码托管平台的默认分支已从master改为main，操作前优先确认远程仓库的默认分支名称，避免因分支名不匹配触发错误。

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