Git的stash命令解析与应用

git stash 是 Git 提供的一个非常有用的命令，用于临时保存当前工作目录和暂存区的修改，以便你可以切换到其他分支或任务，而不需要提交未完成的工作。以下是对 git stash 的详细理解、使用方法以及常见的应用场景。

1. 理解 git stash

• 临时存储：git stash 会将当前工作目录和暂存区的修改保存到一个临时的存储区（stash stack），并将工作目录恢复到上一次提交的状态。
• 栈结构：git stash 使用栈结构来管理多个 stash，最新的 stash 位于栈顶。
• 不包含未跟踪文件：默认情况下，git stash 不会保存未跟踪的文件（即未被 Git 管理的文件）。如果需要保存未跟踪文件，可以使用 git stash -u 或 git stash --include-untracked。

2. 使用 git stash

基本命令

• 保存当前修改：

  git stash
  

  这会保存当前工作目录和暂存区的修改，并将工作目录恢复到上一次提交的状态。

• 保存并添加描述：

  git stash save "描述信息"
  

  你可以为 stash 添加一个描述信息，方便后续识别。

• 查看 stash 列表：

  git stash list
  

  这会列出所有的 stash，每个 stash 都有一个唯一的标识符（如 stash@{0}）。

• 应用最近的 stash：

  git stash apply
  

  这会应用最近的 stash（即栈顶的 stash），但不会从栈中移除它。

• 应用指定的 stash：

  git stash apply stash@{n}
  

  你可以通过指定 stash 的标识符来应用特定的 stash。

• 应用并移除 stash：

  git stash pop
  

  这会应用最近的 stash，并将其从栈中移除。

• 移除 stash：

  git stash drop stash@{n}
  

  这会移除指定的 stash。

• 清空 stash 栈：

  git stash clear
  

  这会清空所有的 stash。

保存未跟踪文件

• 保存未跟踪文件：

  git stash -u
  

  或

  git stash --include-untracked
  

  这会保存未跟踪的文件。

• 保存所有文件（包括忽略的文件）：

  git stash -a
  

  或

  git stash --all
  

  这会保存所有文件，包括被 .gitignore 忽略的文件。

3. 应用场景

场景 1：切换分支时保存未完成的工作

假设你正在 feature-branch 上开发一个新功能，但突然需要切换到 main 分支修复一个紧急 bug。你可以使用 git stash 保存当前的工作进度，切换到 main 分支修复 bug，然后再回到 feature-branch 继续工作。

git stash

git checkout main

git commit -m "Fix critical bug"

git checkout feature-branch

git stash pop

场景 2：临时保存实验性代码

如果你正在尝试一些实验性的代码，但不确定是否会保留这些修改，可以使用 git stash 来临时保存这些修改。如果实验成功，你可以应用 stash；如果失败，你可以丢弃 stash。

git stash

# ...

git stash pop

# 如果实验失败，丢弃 stash
git stash drop

场景 3：清理工作目录

如果你需要清理工作目录以进行一些操作（如合并分支、拉取远程分支等），但又不想提交未完成的工作，可以使用 git stash 来临时保存这些修改。

git stash

git merge some-branch

git stash pop

4. 总结

git stash 是一个非常强大的工具，能够帮助你在不提交未完成工作的情况下，临时保存和恢复工作目录的修改。它在切换分支、处理紧急任务、清理工作目录等场景中非常有用。掌握 git stash 的使用方法，可以大大提高你的开发效率。