Bash脚本中如何编程区分Git分支、轻量标签与附注标签

git cat-file -t 仅返回引用直接指向的底层Git对象类型：附注标签会指向独立的tag对象，因此返回tag；本地分支、轻量标签均直接指向commit对象，二者返回值完全一致，无法仅通过对象类型区分。
Git的引用按命名空间隔离存储，区分引用类型的核心依据是其所属的命名空间：

• 本地分支存放在refs/heads/路径下
• 所有标签（含附注、轻量）存放在refs/tags/路径下
• 远程跟踪分支存放在refs/remotes/路径下

使用git rev-parse --symbolic-full-name 获取输入引用被Git实际解析后的完整路径是最可靠的方案，该命令完全遵循Git原生的引用解析优先级（标签>本地分支>远程分支），即使存在同名的分支和标签也不会出现判定错误。
判定流程：

1. 保留原有逻辑：cat-file -t返回tag时，直接判定为附注标签
2. 当返回值为commit时，获取引用的完整路径做判断：
   • 路径前缀为refs/heads/：本地分支
   • 路径前缀为refs/tags/：轻量标签
   • 路径前缀为refs/remotes/：远程跟踪分支（可按需扩展处理逻辑）

# paths that have Git repos
paths[0]="./playground"
paths[1]="./sandbox"

# reference objects common to all repos
references[0]="main"
references[1]="v1"
references[2]="v2"
references[3]="v3"

echo "Object type of reference in each repository -"
for reference in "${references[@]}"
do
    echo "~~~ $reference ~~~"
    for path in "${paths[@]}"
    do
        # 校验引用是否存在，避免无效引用导致脚本报错
        if ! git -C "$path" rev-parse --verify "$reference" >/dev/null 2>&1; then
            echo "missing   - $path"
            continue
        fi

        OBJECT_TYPE=$(git -C "$path" cat-file -t "$reference")
        if [ "$OBJECT_TYPE" = "tag" ]; then
            prefix="annotated"
        else
            FULL_REF=$(git -C "$path" rev-parse --symbolic-full-name --verify "$reference")
            case "$FULL_REF" in
                refs/heads/*)
                    prefix="branch"
                    ;;
                refs/tags/*)
                    prefix="lightweight-tag"
                    ;;
                refs/remotes/*)
                    prefix="remote-branch"
                    ;;
                *)
                    prefix="other-ref"
                    ;;
            esac
        fi
        echo "$prefix $OBJECT_TYPE $path"
    done
    echo
done

不要用遍历git show-ref结果匹配分支/标签名的方式做判定：当仓库存在同名分支和标签时，该方法会匹配到多条结果，和Git实际解析引用的逻辑不一致，极易出现误判。

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