问题
Windows 用户经常会遇到这个问题
git pull
给出错误:error: cannot lock ref
unable to update local ref
原因
原因 a)有多个分支,其
名称从开头到任何斜线(或到结尾)仅在大写和小写上有所不同。
Branch name clashing (upper/lower case)
#######################################
# Example 1)
#############################
feature/releasecandidate/fix123
feature/releaseCandidate/improveFeature789
------------------------
^
Identical from beginning up to a slash (here the 2nd one)
except for the marked letter, where the upper/lower case differs
# Example 2)
#############################
releaseBranch
releasebranch
-------------
^
Identical from beginning to the end
except for the marked letter
原因b) linux上的一个问题:一个分支是另一个分支的前缀,带有斜线边界:
Prefix with slash-boundary
#######################################
# Example 1) - also a problem on linux
#############################
feature/release2021
feature/release2021/fixIssue07
^
slash boundary
# Example 2)
#############################
feature/release2022
feature/Release2022/fixIssue99
^ ^
differing case slash boundary
(problem on
windows)
解决方案
消除原因(参见上面的确切原因)。
# inspect your branches, to see if you have the upper/lower case problem
git ls-remote --heads YOUR-GIT-URL
例如:创建一个分支命名策略,例如全部小写;或最后一个斜线之前的小写字母。或者一些智能钩子,可以检测违规行为。(但请注意:在原因 a)问题仅在 Windows 上,不在 linux 上)。
背景
问题是 Windows 将这些分支(来自示例 1 和 2)存储在.git
文件夹中
# inspect the files/folders under
.git/refs/remotes/origin/
并且在原因 a) windows 无法区分大写/小写的差异,因此 git on window 变得疯狂。
在原因 b)中,您不能拥有与文件 ( feature/release2021/
) 同名的文件夹 (例如feature/release2021
)。
解决方法
通常有效的短期解决方法(直到您消除了原因)是:
git pack-refs --all
# delete the contents of .git/refs/remotes/origin/*
rm -rf .git/refs/remotes/origin/*
git pull; git pull; git pull # all good? yes!