执行git clone --bare与git worktree add后遇HEAD歧义警告的解决咨询

问题原因 #

Git 中HEAD是特殊引用，默认指向当前分支的最新提交，但你的仓库存在两个异常情况：

• 本地创建了名为HEAD的分支，违反Git命名规范
• 远程仓库存在两个HEAD引用指向
  这导致Git无法区分特殊符号HEAD和分支名HEAD，触发歧义警告，最终创建工作树时因无法解析HEAD的正确对象而报错。

解决步骤 #

1. 删除本地违规的HEAD分支 #

cd E:\repos\foo.git
git branch -D HEAD

2. 清理远程仓库的多余HEAD引用 #

如果远程仓库存在名为HEAD的分支，推送删除：

git push origin --delete HEAD

注：若远程HEAD是误配置的引用，先确认远程默认分支（如master/main）的HEAD指向正常，再联系管理员操作。

3. 修复裸仓库的HEAD指向 #

确保裸仓库的HEAD正确指向默认分支：

git symbolic-ref HEAD refs/heads/master

（默认分支为main时，改为refs/heads/main）

4. 重新创建工作树 #

现在可正常创建dev/bar工作树：

git worktree add dev/bar

或指定基于master分支创建：

git worktree add dev/bar master

推荐的 Git Worktree 配置方式 #

• 优先使用普通仓库而非裸仓库：普通仓库管理更直观，克隆后直接添加工作树：

  cd E:\repos
  git clone <repository-url>/foo
  cd foo
  # 创建master分支的独立工作树
  git worktree add ../foo-master master
  # 基于当前分支新建dev/bar分支并创建工作树
  git worktree add ../foo-dev-bar dev/bar
  

• 规避Git保留字作为分支名：禁止使用HEAD、FETCH_HEAD等特殊关键字命名分支
• 定期清理无效工作树：执行git worktree prune清理已删除的工作树记录，保持仓库整洁

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