Git推送提交时出现’src refspec master does not match any’错误的解决办法

技术背景

在使用Git进行代码管理时，有时会遇到 src refspec master does not match any 这样的错误信息。这个错误通常在执行 git push 命令时出现，意味着你尝试推送的分支在本地并不存在或者没有有效的提交。

实现步骤

1. 检查是否提交

如果在执行 git push 之前没有进行提交操作，就会出现该错误。比如以下操作：

mkdir repo && cd repo
git init
git remote add origin /path/to/origin.git
git add .
git push -u origin master

此时会报错，因为没有进行提交。解决方法是进行提交：

git commit -m "initial commit"
git push origin main

2. 查看引用

可以使用 git show-ref 查看引用。由于GitHub将默认分支从 master 改为 main，可能会发现有 refs/heads/main。可以使用 git push origin HEAD:main 进行推送。

3. 解决删除文件后的问题

如果在本地删除所有文件后出现该错误，可以执行以下操作：

touch README
git add README
git add (all other files)  # 或者使用 git add --all :/
git commit -m'reinitialized files'
git push origin master --force  # 注意：--force 可能会删除他人的工作

4. 正确初始化和提交

缺少 git add . 或 git commit 可能导致该错误。正确的操作顺序是：

git init
git add .
git commit -m'message'
git remote add origin <remote_repository_url>
git push -u origin master

5. 处理特定分支问题

如果你在一个特定分支上，尝试推送一个不存在的分支，会出现该错误。可以创建分支后再推送：

git checkout -b "master"
git push -u origin master

6. 处理不同默认分支问题

由于GitHub将默认分支从 master 改为 main，如果仓库的默认分支是 main，使用 git push origin main 进行推送。

7. 处理分离HEAD状态

如果在分离HEAD状态下遇到该错误，可以使用以下命令：

git push origin HEAD:remote-branch-name

8. 推送所有本地分支

如果从外部仓库检出代码并导入到个人或内部系统，可以使用以下命令推送所有本地分支：

git push --all origin

核心代码

# 基本操作顺序
git init
git add .
git commit -m "message"
git remote add origin <remote_repository_url>
git push -u origin master

# 处理不同默认分支
git push origin main

# 处理分离HEAD状态
git push origin HEAD:remote-branch-name

# 推送所有本地分支
git push --all origin

最佳实践

• 在进行 git push 之前，确保已经进行了 git add 和 git commit 操作。
• 注意仓库的默认分支是 master 还是 main，使用正确的分支名进行推送。
• 使用 --force 选项时要谨慎，因为它可能会覆盖远程仓库的内容。

常见问题

1. 忘记添加 .gitignore 文件

解决方法：在本地创建 .gitignore 文件，然后按照以下步骤操作：

git remote add origin YOUR/ORIGIN.git
git add .
git commit -m "initial commit or whatever message for first commit"
git push -u origin master

2. 尝试创建新的GitHub项目

由于GitHub将默认分支改为 main，可以按照以下步骤操作：

# 若存在.git文件夹，先删除
rm -rf .git
git init
git add .
git commit -m "YOUR FIRST MESSAGE HERE"
git branch -M main
git remote add origin <GIT_LINK_TO_PROJECT_HERE>
git push -u origin main