无需条件判断，Git原生方式保存与恢复HEAD的方法？

我需要执行一系列操作，过程中要先保存当前HEAD状态，之后再恢复它。最初的思路是直接读写.git/HEAD文件：

# 保存HEAD
original_head="$(cat .git/HEAD)"

# 执行其他会改动HEAD的操作
# ...

# 恢复HEAD
echo -n "$original_head" > .git/HEAD

这种直接用cat和echo操作文件的方式只是演示，并非Git原生方法，可靠性很差——比如在.git是文件的新建工作树场景下就会失效。

稍优但有局限的方案：git symbolic-ref #

后来改用git symbolic-ref的方案，比直接操作文件靠谱一些：

# 保存HEAD
original_head="$(git symbolic-ref HEAD)"

# 恢复HEAD
git symbolic-ref HEAD "$original_head"

但这个方法在HEAD处于分离状态时会直接报错：

# 切换到分离HEAD状态
git checkout $(git rev-parse HEAD)
 
# 尝试保存HEAD的值：
git symbolic-ref HEAD
fatal: ref HEAD is not a symbolic ref

我当前的解决方案：条件判断规避问题 #

我现在是通过条件判断来区分两种场景的：

# 保存HEAD
symbolic_head=''
detached_head=''
if git symbolic-ref HEAD >/dev/null 2>&1; then
  symbolic_head="$(git symbolic-ref HEAD)"
else
  detached_head="$(git rev-parse HEAD)"
fi

# 执行其他会改动HEAD的操作
# ...

# 恢复HEAD
if [[ -n $symbolic_head ]]; then
  git symbolic-ref HEAD "$symbolic_head"
else
  git update-ref HEAD "$detached_head"
fi

核心问题 #

有没有更直接的Git原生方法，能统一获取并设置HEAD的值，不管它是符号引用还是处于分离状态？

最优解决方案 #

Git没有单一的原生命令可以同时处理两种场景，但可以用更简洁的Git命令组合实现，避免繁琐的条件判断：

保存HEAD状态 #

# 统一获取HEAD的目标：符号引用返回refs路径，分离状态返回哈希值
original_head=$(git rev-parse --symbolic-full-name HEAD 2>/dev/null || git rev-parse HEAD)

恢复HEAD状态 #

# 根据保存的值类型选择对应命令
if [[ "$original_head" == refs/* ]]; then
  git symbolic-ref HEAD "$original_head"
else
  git update-ref HEAD "$original_head"
fi

原理说明 #

• git rev-parse --symbolic-full-name HEAD：当HEAD指向分支（符号引用）时，返回完整的引用路径（如refs/heads/main）；若处于分离状态，该命令会报错，此时通过||执行git rev-parse HEAD获取HEAD对应的哈希值。
• 恢复时，只需判断保存的值是否以refs/开头：是则用git symbolic-ref恢复分支引用，否则用git update-ref直接设置HEAD的哈希值。

备选方案：用git checkout恢复（注意工作区变动） #

如果你不介意切换工作区，也可以用git checkout直接恢复HEAD，但该命令会同步改变工作区和索引（未提交修改需先暂存）：

# 保存HEAD对应的哈希值
original_head=$(git rev-parse HEAD)
# 执行其他操作...
# 恢复HEAD（同步切换工作区到对应状态）
git checkout "$original_head"

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