如何用Git制作工作目录快照，保留当前状态且便于后续恢复？

这个需求太戳日常开发的痛点了！我之前也遇到过类似的问题——想用git stash save -u存快照，但又不想动当前工作目录，而且过阵子恢复时还要找当时的状态，简直麻烦。下面给你几个完美适配需求的方案：

一、保持工作目录不变的快照保存方法 #

git stash save -u会把改动和未跟踪文件都藏起来，导致工作目录变干净，这显然不符合你的需求。我们可以拆分成两步操作，只生成快照但不修改工作区：

1. 用git stash create -u生成一个包含未跟踪文件的快照对象，它会返回这个对象的哈希值（完全不会改变工作目录）
2. 用git stash store把这个哈希值对应的对象存入stash列表，还能加备注方便以后识别

具体命令：

# 生成快照并获取哈希值
STASH_HASH=$(git stash create -u)
# 将快照存入stash列表，自定义备注（比如加上日期和用途）
git stash store -m "快照：2024-05-20 用户中心功能开发进度" $STASH_HASH

执行完这两步，你的工作目录和之前完全一样——未跟踪文件还是未跟踪，改动也都保留，同时快照已经安全存在stash列表里了。

二、无需定位原状态的恢复方法 #

普通git stash apply确实需要你回到当初执行stash时的分支/提交状态，否则很容易出冲突。更稳妥的方式是创建新分支来恢复快照，这样不管你现在在哪个分支、哪个提交上，都能轻松恢复，还不会干扰当前工作：

1. 先查看所有快照，找到你需要的那个：

git stash list

输出大概是这样的：

stash@{2}: On main: 快照：2024-05-20 用户中心功能开发进度

2. 创建新分支并恢复该快照：

git stash branch restore-snapshot-20240520 stash@{2}

这条命令会自动创建一个名为restore-snapshot-20240520的新分支，然后把快照的内容完全恢复到这个分支里。整个过程不需要你切换回原来的状态，安全又省心。

三、封装成自定义命令（懒人必备） #

如果经常用这个操作，不如把它封装成一个自定义Git命令，用起来更顺手：

1. 创建一个名为git-snapshot的脚本，内容如下：

#!/bin/bash
# 自定义Git快照命令，保持工作目录不变，带时间戳备注

# 自定义备注，支持传入参数，比如 git snapshot "用户中心开发进度"
COMMIT_MSG="快照：$(date '+%Y-%m-%d %H:%M:%S') ${1:-临时快照}"

# 生成快照哈希
STASH_HASH=$(git stash create -u)

if [ -n "$STASH_HASH" ]; then
  git stash store -m "$COMMIT_MSG" "$STASH_HASH"
  echo "✅ 已创建快照：$COMMIT_MSG"
  echo "🔍 快照哈希：$STASH_HASH"
else
  echo "ℹ️ 当前工作目录没有可快照的内容"
fi

2. 给脚本添加执行权限：

chmod +x git-snapshot

3. 把脚本放到你的系统PATH目录下（比如/usr/local/bin），这样就能像用普通Git命令一样调用：

git snapshot "用户中心功能开发进度"

为什么这个方案比git stash save -u更好？ #

• 🌟 工作目录完全不变：未跟踪文件保持未跟踪状态，改动也不会被隐藏
• 🔖 快照带清晰备注：以后用git stash list一眼就能找到对应的快照
• 🛡️ 恢复更安全：用新分支恢复，不用回到原状态，避免冲突影响当前工作

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