Git 是一个开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目。现在有很多的公司都在使用，我的公司也使用了 Git。学会 Git 几乎成了开发者的必备技能，有很多的求职者在简历里面都会写上熟练 Git ，但是，你真的都懂吗？

最近，项目的分支规范变了，当我们使用新的分支规范时出现了问题，不能创建分支，也不能提交。我仔细观察了一下报错，发现是因为我们新的分支规范在分支名称的最前面加了一个路由，而这个路由曾经是我们使用的一个分支，导致本应该在新建分支时在 .git 目录上新建一个文件夹，而现在那个路由存在而且是个文件导致了报错。

首先，说一下问题可能发生的场景。

1. 本地和远程已经存在分支 test 时，当我们新建 test/staging 分支时，会报 fatal: cannot lock ref 'refs/heads/test/staging': 'refs/heads/test' exists; cannot create 'refs/heads/test/staging'。

无法新建分支

前提：当本地不存在 test 分支，我们新建了一个 test/staging 分支。

创建分支

2. 当向远程 push 时，就会报! [remote rejected] test/staging -> test/staging (cannot lock ref 'refs/heads/test/staging': 'refs/heads/test' exists; cannot create 'refs/heads/test/staging')。

remote rejected

3. 当向远程 push 时，会报 error: update_ref failed for ref 'refs/remotes/origin/test/staging': cannot lock ref 'refs/remotes/origin/test/staging': 'refs/remotes/origin/test' exists; cannot create 'refs/remotes/origin/test/staging'。

update_ref failed

为什么会报错呢？

问题原因

根据报错提示，我们可以想到是由于建立分支的名称出错，test 已经存在。

可我们新建的是 test/staging 分支，不是 test 分支？

这是由于 Git 建立分支时会在 'refs/remotes' 下按路径建立文件，test 分支存在的话，就是存在了名为 test 的文件。而我们再使用命令新建 test/staging 分支时，会建立一个名为 test 的文件夹，并在文件夹下建立一个名为 staging 的文件，因此发生了冲突而报错。

也就是说在 refs/remotes 下的 test 是个文件，而当我们再次新建 test 文件夹的时候就与 test 同名的文件产生了冲突，从而导致了报错。

我们终于找到了报错的原因。

我们再详细看一下上面的三个场景的报错：

场景1：无法新建分支

我们首先查看本地的分支，发现已经存在 test 分支，删除 test 分支后再次尝试新建，这时已经可以新建分支，此报错已解决。

查看本地分支

场景2：remote rejected

远端拒绝，通过查看远端分支，发现远端存在 test 分支，因此删去 test 分支，再次尝试解决此报错。

查看全部分支

场景3：update_ref failed

本地分支跟远程分支不匹配。

Git 工程的 .git/refs 目录下跟踪的 git 分支，在 git push 的时候，与远端的 refs 对比发现不同，所以导致 git push 报错。

解决方法

既然已经知道了原因，那我们赶紧解决它！

1. 删除本地的 test 分支（如果没有请忽略）。

2. 删除远端的 test 分支（如果没有请忽略）。

3. 备份好修改的代码。

4. cd 到 .git/refs/remotes/origin 路径下。

查看 git 路径下的文件

5. 删除报错的分支。

删除 test 分支

此时，如果我们再次尝试 push ，会提示：error: update_ref failed for ref 'refs/remotes/origin/test/staging': cannot update the ref 'refs/remotes/origin/test/staging': unable to append to '.git/logs/refs/remotes/origin/test/staging': Not a directory

git push 操作报错

这是因为更新 ref 时出错，test 是个文件并不是目录。可以 cd 到 .git/logs/refs/remotes/origin 路径下删除 test 文件来解决。

删除 logs 下的 test 文件

6. 切换到其它的分支（不要在报错分支上，切换到其它的分支）。

切换到 master 分支

7. 拉取远程分支（git fetch -p）。

拉取远程分支

8. 执行 git pull 操作，查看是否正常。

git pull

9. 删除报错的分支（git branch -D *）。

删除报错分支

10. 检出报错分支（git checkout *）。

切换分支

11. 查看分支操作是否正常（git pull）。

查看 git 操作是否正常

12. 将备份好的修改的代码合并过来。

现在，cannot create 'refs/remotes/origin/*' 报错已经圆满地解决了，我们可以放心地提代码了。

我将此次处理地经过记录在此，希望可以帮助其它同样遇到这个问题的小伙伴节省些时间，也希望可以帮助更多的小伙伴了解 Git 分支。