如何从GitLab服务器仓库直接获取正确的Git引用名称？

问题原因 #

GitLab服务器上的仓库是裸仓库，并且GitLab会自动创建refs/keep-around/开头的引用保留提交（防止被垃圾回收机制清理），这就是你用git log --format=%d只能看到该引用的原因。而你本地克隆的仓库里，origin/main是远程分支的本地跟踪引用，所以能显示对应的分支名。

解决方案 #

1. 直接利用update钩子的内置参数 #

update服务器端钩子在触发时会自动接收三个关键参数，完全不需要通过git log查询引用名：

• $1: 被更新的引用完整路径（比如refs/heads/main）
• $2: 引用更新前的提交哈希
• $3: 引用更新后的新提交哈希

你可以直接在脚本中提取分支名和提交信息：

# 获取引用名称和分支名
ref_name="$1"
branch_name=$(basename "$ref_name")  # 把refs/heads/main转成main

# 获取新提交的提交信息
commit_msg=$(git log --format=%B -n 1 "$3")

2. 查找指向目标提交的所有有效分支/标签 #

如果确实需要找到某个提交关联的所有分支（而非当前更新的分支），可以用git for-each-ref遍历所有引用，筛选出指向目标提交的条目：

target_commit="632f8f615d5904020b7bf1111d1eda3e163d9af3"

# 获取所有指向该提交的短引用名（如main、tags/v1.0）
git for-each-ref --format="%(refname:short)" --points-at "$target_commit"

# 如果需要和本地格式一致的"origin/main"，可以手动拼接并过滤内部引用
git for-each-ref --format="origin/%(refname:short)" --points-at "$target_commit" | grep -v keep-around

这个命令会过滤掉refs/keep-around这类GitLab内部引用，只返回实际的分支和标签名。

3. 补充说明 #

GitLab服务器上的分支实际存储在refs/heads/目录下，本地的origin/main对应的就是服务器上的refs/heads/main，所以用上述方法得到的分支名，加上origin/前缀就和本地显示的格式一致了。

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