Git工作树分支名不显示问题求助（WSL2+Zsh环境）

1. 检查Zsh Git提示符插件支持 #

如果使用Oh My Zsh的git插件，旧版本可能仅识别.git目录，而Git工作树的目录中是.git文件（指向主仓库的.git/worktrees/xxx目录），导致无法识别：

• 确认~/.zshrc中plugins数组包含git；
• 执行omz update更新Oh My Zsh到最新版本，新版git插件已支持Git工作树识别。

2. 自定义Git分支检测逻辑 #

若更新插件后问题仍存在，可在~/.zshrc末尾添加自定义的分支检测函数，覆盖默认逻辑：

function git_prompt_info() {
  local ref
  # 同时兼容.git目录与.git文件（Git工作树）
  if [[ -d .git || -f .git ]]; then
    ref=$(git symbolic-ref --short HEAD 2> /dev/null) || ref=$(git rev-parse --short HEAD 2> /dev/null)
    if [[ -n "$ref" ]]; then
      echo "$ZSH_THEME_GIT_PROMPT_PREFIX${ref}$(parse_git_dirty)$ZSH_THEME_GIT_PROMPT_SUFFIX"
    fi
  fi
}

添加后执行source ~/.zshrc生效，再切换到目标目录测试。

3. 修复WSL挂载Windows路径的权限问题 #

Windows主目录挂载到WSL的路径（如/mnt/c/Users/xxx）下的仓库，可能因权限异常导致Git命令执行失败：

• 在问题仓库目录执行git branch，若无法返回分支，执行以下命令修复权限：

  sudo chown -R $USER:$USER /mnt/c/Users/xxx/your-repo-path
  

• 确保路径无特殊字符（如空格），避免Zsh解析异常。

4. 排查Dotfiles配置冲突 #

你的wsl-dotfiles仓库可能覆盖了默认Git提示符配置：

• 检查仓库中的Zsh配置文件（如~/.zshrc或自定义prompt脚本），确认是否存在禁用git插件、重写git_prompt_info但未兼容工作树的逻辑；
• 暂时注释自定义prompt相关配置，执行source ~/.zshrc测试，若恢复正常则调整自定义代码兼容工作树。

5. 验证基础Git命令可用性 #

在无法显示分支的目录，执行以下命令确认Git本身是否正常：

git status
git symbolic-ref --short HEAD

若命令能正常返回分支名，说明问题出在Zsh提示符逻辑；若命令报错，优先修复Git仓库本身问题（如仓库损坏、路径配置错误）。

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