如何临时切换Git版本并恢复仓库初始状态？

我正在编写脚本，需要通过代码完成以下操作：

1. 切换至某个Git revision；
2. 基于该版本执行只读操作；
3. 将仓库恢复至脚本启动前的状态（即切回原版本），且需还原所有本地变更，确保三步无副作用。

我尝试了以下命令：

git stash --include-untracked
git name-rev --name-only HEAD # Save to <HEAD_REV>
git checkout <NEW_REV>

# Do stuff 

git checkout <HEAD_REV>
git stash pop

但不确定是否存在边缘场景导致无法恢复仓库状态，想了解Git中的标准实现方式。

原方案的潜在问题 #

你的现有方案存在几个边缘场景可能导致仓库状态无法完全恢复：

• stash恢复冲突：如果脚本执行期间原分支有新提交，或者暂存内容和当前分支状态冲突，git stash pop会触发冲突，导致暂存的变更无法自动恢复，脚本中断且仓库处于不一致状态。
• 引用失效：git name-rev --name-only HEAD返回的是分支名或相对引用（比如master~1），若原分支被强制更新、重命名或删除，这个引用会失效，导致切回原版本失败。
• 未跟踪文件被覆盖：如果<NEW_REV>中存在和本地未跟踪文件同名的文件，git checkout <NEW_REV>会直接覆盖这些文件；若stash操作因权限等问题失败，会直接丢失本地文件。

Git官方推荐的无副作用方案 #

最安全的方式是使用git worktree创建独立的临时工作区，完全隔离原仓库的状态，从根源避免副作用：

# 创建临时目录作为独立工作区
TEMP_WORKDIR=$(mktemp -d)
# 将临时工作区关联到目标revision，--detach表示不绑定到分支
git worktree add --detach "$TEMP_WORKDIR" <NEW_REV>

# 进入临时工作区执行只读操作
cd "$TEMP_WORKDIR"
# Do stuff（所有操作仅影响临时目录，和原仓库完全无关）
cd -

# 清理临时工作区，移除Git关联并删除目录
git worktree remove "$TEMP_WORKDIR"
rm -rf "$TEMP_WORKDIR"

这种方式的核心优势：

• 原仓库的工作区、暂存区、分支状态完全不受干扰，无需处理stash、冲突或引用失效问题。
• 临时工作区独立存在，即使<NEW_REV>有同名文件，也只会在临时目录中操作，不会覆盖原仓库的本地文件。
• 只读操作完全隔离，不存在任何遗留副作用。

原方案的优化版本（必须在原工作区操作时） #

如果因为依赖原仓库配置等原因必须在原工作区操作，可以通过以下优化规避风险：

# 保存原HEAD的绝对哈希值（避免分支引用变化导致失效）
ORIG_HEAD=$(git rev-parse HEAD)
# 保存所有本地变更：包括未跟踪、忽略文件，添加stash消息便于识别
git stash push --include-untracked --all -m "script-temp-stash"

# 切换到目标revision，用哈希值确保定位准确
git checkout <NEW_REV>

# Do stuff 

# 强制切回原版本，避免工作区状态导致的切换失败
git checkout "$ORIG_HEAD" --force
# 恢复stash，指定条目避免误操作，失败时保留stash以便排查
if ! git stash pop stash@{0}; then
    echo "Stash恢复失败，保留stash条目：stash@{0}"
fi

优化点说明：

• 用git rev-parse HEAD获取绝对哈希值，彻底避免分支引用变化的问题。
• git stash push --all包含忽略文件（按需使用），并添加明确的stash消息，方便后续排查问题。
• 切回时加--force参数，确保无论工作区状态如何都能成功切换回原版本。
• 对stash pop做错误处理，避免冲突导致脚本中断且状态丢失。

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