如何通过Git原生方式检查特定分支是否在任一工作树中被检出？

针对你的需求，有两种更稳定的Git原生方法，无需依赖git branch的不稳定输出：

方法1：使用git worktree list（适用于多工作树场景） #

git worktree list是专门用于管理多工作树的命令，输出格式有明确规范，适合脚本解析。它的每行输出格式为：<工作树路径> <提交哈希> <分支引用>，例如/home/user/repo abc1234 (main)。

可以用以下脚本检查目标分支是否被任一工作树检出：

target_branch="your-branch-name"

if git worktree list | awk -v target="$target_branch" '$3 == "(refs/heads/"target")" { exit 0 } END { exit 1 }'; then
  >&2 echo "Target branch '${target_branch}' is already checked out."
  exit 1
fi

原理：通过awk匹配输出的第三列（分支引用）是否等于目标分支的完整引用格式(refs/heads/[分支名])，如果匹配到则说明分支已被检出。

方法2：使用git for-each-ref（底层plumbing命令，输出绝对稳定） #

git for-each-ref是Git的底层命令（plumbing），输出格式完全稳定，适合脚本自动化场景。可以利用它的格式符查询分支的检出状态：

target_branch="your-branch-name"

if git for-each-ref --format='%(if:equals=%(refname:short))'"$target_branch"'%(then)%(worktree)%(end)' refs/heads | grep -q .; then
  >&2 echo "Target branch '${target_branch}' is already checked out."
  exit 1
fi

原理：%(worktree)格式符会输出分支被检出的工作树路径，如果分支未被任何工作树检出则输出空值。通过筛选目标分支并检查%(worktree)是否有内容，即可判断分支是否被检出。

为什么这些方法更可靠？ #

• git worktree list虽然属于porcelain命令，但针对多工作树场景设计，输出格式有官方文档定义，不会随意变更；
• git for-each-ref是底层plumbing命令，专门为脚本和自动化工具设计，输出格式绝对稳定，完全避免了git branch这类面向用户的命令可能出现的格式变动问题。

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