从CVS迁移Git后HEAD引用歧义问题排查（无HEAD分支）

嘿，这个问题我之前帮同行排查过，虽然你明确说没有HEAD分支，但Git里的“歧义”可不止局限于分支哦！结合你用CVS转Git的场景，大概率是这几个原因：

• 存在名为HEAD的标签（Tag）
  CVS里经常会有各种自定义标签，如果你原CVS仓库里恰好有一个叫HEAD的标签，转换工具（比如你用的crap）会把它同步成Git的标签。而Git本身有一个特殊的HEAD引用（指向当前分支的指针），当Git看到你引用HEAD时，它会同时匹配到这个标签和内置的特殊引用，就会抛出歧义警告。你可以用git tag | grep HEAD快速验证有没有这个标签。

• 其他命名空间的HEAD引用
  除了分支和标签，Git的引用还可能存在于其他命名空间，比如远程分支（refs/remotes/origin/HEAD）或者一些工具生成的自定义引用。你可以用git show-ref | grep HEAD列出所有包含HEAD的引用，看看有没有除了默认的HEAD指针之外的异常条目。

• 转换工具残留的异常引用文件
  有些CVS转Git的工具可能在导出时生成了奇怪的引用文件。你可以直接检查本地Git仓库的.git/refs目录，看看有没有名为HEAD的文件；或者查看.git/packed-refs文件，搜索有没有包含HEAD的打包引用条目。

快速验证命令 #

你可以依次运行这些命令定位问题：

# 检查所有含HEAD的引用
git show-ref | grep HEAD

# 检查是否存在HEAD标签
git tag | grep HEAD

# 检查本地refs目录下的异常文件
ls -la .git/refs/heads/ .git/refs/tags/ | grep HEAD

绝大多数情况下，都是原CVS仓库的HEAD标签导致的冲突——毕竟CVS里用HEAD做标签名不算罕见，而Git对这个名字有特殊意义，所以就撞车啦！

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