【Git “stash“ 命令详解】_git stash

本章目录:

• • 1. 命令简介
  • • 常见用途：
  • 2. 命令的基本语法和用法
  • • 基本语法：
    • 使用场景与实际例子
    • • 示例 1：保存当前更改并恢复到干净状态
      • 示例 2：查看当前所有的 stash 条目
      • 示例 3：应用最近保存的 stash
      • 示例 4：应用特定的 stash
  • 3. 命令的常用选项及参数
  • • 常用选项：
  • 4. 命令的执行示例
  • • 示例 1：将所有更改存储到 stash
    • 示例 2：查看所有 stash 条目
    • 示例 3：应用最近保存的 stash
    • 示例 4：删除已应用的 stash 条目
  • 5. 命令的进阶用法
  • • 用法 1：保存当前工作并切换分支
    • 用法 2：选择性保存部分更改
  • 6. 命令的常见问题与解答
  • • 问题 1：如何恢复已保存的 stash？
    • 问题 2：如何清空所有 stash？
    • 问题 3：如何查看某个 stash 的内容？
  • 7. 总结与建议
  • • 最佳实践建议：

1. 命令简介

git stash 命令用于临时保存当前工作目录和暂存区的改动，使得工作区能够恢复到上一次提交的干净状态。这对于在开发过程中需要切换分支但不想提交当前修改的情况非常有用。你可以将工作进度“存放”起来，稍后再回来继续工作。

常见用途：

• 切换分支时保存当前工作：当你在当前分支上有未提交的更改，并且需要临时切换到其他分支处理问题时，可以使用 git stash 来保存这些更改。
• 避免提交不完整的工作：当你正在开发一个功能，途中遇到需要解决的紧急问题时，可以暂时将当前工作保存在 stash 中，待解决完紧急问题后再回来继续。
• 多任务处理：在一个任务的中间，切换到另一个任务时，你可以使用 git stash 临时存储工作，以便稍后恢复。

2. 命令的基本语法和用法

基本语法：

git stash [<options>]

没有提供选项时，git stash 会将所有未提交的更改（包括工作目录和暂存区的改动）保存到栈中，并将工作目录恢复为最新的提交状态。

使用场景与实际例子

示例 1：保存当前更改并恢复到干净状态

git stash

该命令会将工作目录和暂存区的所有改动保存到 stash 中，并将工作目录恢复为与上一次提交一致的状态。

示例 2：查看当前所有的 stash 条目

git stash list

这会列出所有的 stash 条目，每个条目都用一个标识符（例如 stash@{0}）进行区分。

示例 3：应用最近保存的 stash

git stash apply

此命令会将最近一次的 stash 应用到当前分支。它不会从栈中移除该条目，你可以在以后再次应用它。

示例 4：应用特定的 stash

git stash apply stash@{1}

当你有多个 stash 条目时，可以指定特定的 stash 来应用。stash@{1} 指的是第二个保存的 stash。

3. 命令的常用选项及参数

git stash 提供了多个选项，可以控制它的行为，下面是一些常见的选项：

常用选项：

• -u 或 --include-untracked：除了包含已跟踪文件的改动外，还会保存未跟踪的文件。

  示例：

  git stash -u

  该命令会将未跟踪的文件（如新创建的文件）也保存到 stash 中。

• -a 或 --all：除了未跟踪的文件外，还会将忽略文件（.gitignore 文件中列出的文件）保存到 stash 中。

  示例：

  git stash -a

  使用此选项时，除了未跟踪文件，还包括被 .gitignore 忽略的文件会一起被保存到 stash 中。

• --keep-index：保存工作目录的改动，但不保存暂存区的内容。此选项会将暂存区的更改保持不变，仅保存工作目录的改动。

  示例：

  git stash --keep-index

  如果你想要暂存区的内容不被影响，只保存工作目录中的更改，可以使用该选项。

• -p 或 --patch：交互式地选择更改进行保存。通过此选项，你可以选择性地将工作区中的某些修改保存到 stash 中，而不是将所有更改都保存。

  示例：

  git stash -p

  运行此命令后，Git 会逐个显示你所做的更改，并让你决定是否将它们保存到 stash。

4. 命令的执行示例

示例 1：将所有更改存储到 stash

git stash

输出：

Saved working directory and index state WIP on master: 6b2a589 update readme

解释：

• git stash 会将工作目录和暂存区的所有更改保存起来，恢复到干净的状态。
• WIP on master 表示在 master 分支上工作，6b2a589 是当前提交的哈希值。

示例 2：查看所有 stash 条目

git stash list

输出：

stash@{0}: WIP on master: 6b2a589 update readmestash@{1}: WIP on develop: 34b6c82 fix authentication bug

解释：

• git stash list 会列出所有的 stash 条目，并为每个条目分配一个唯一的标识符（例如 stash@{0}、stash@{1}）。
• 输出显示了当前栈中存在两个 stash 条目，其中 stash@{0} 是最新的 stash。

示例 3：应用最近保存的 stash

git stash apply

输出：

Auto-merging file1.txtAuto-merging file2.txt

解释：

• git stash apply 会将最近的 stash 应用到当前分支。
• 如果有冲突，Git 会提示需要手动解决冲突。

示例 4：删除已应用的 stash 条目

git stash drop stash@{0}

输出：

Dropped stash@{0} (6b2a589 update readme)

解释：

• git stash drop 会删除指定的 stash 条目（在这个例子中是 stash@{0}），以防止栈中积累过多的条目。

5. 命令的进阶用法

用法 1：保存当前工作并切换分支

如果你正在开发一个新功能，但需要切换到另一个分支去修复一个紧急 bug，可以使用 git stash 暂时保存你的工作：

git stashgit checkout bugfix-branch

这样，当前工作就被保存到 stash 中，可以在切换回原分支时恢复。

用法 2：选择性保存部分更改

如果你只想保存某些文件的更改，而不保存全部修改，可以使用 git stash -p：

git stash -p

然后根据交互式提示，选择保存哪些更改。

6. 命令的常见问题与解答

问题 1：如何恢复已保存的 stash？

解答：你可以使用 git stash apply 来恢复最近一次保存的 stash，或使用 git stash apply stash@{n} 来恢复特定的 stash。

问题 2：如何清空所有 stash？

解答：使用 git stash clear 命令可以清空所有的 stash 条目：

git stash clear

这会删除栈中的所有保存的更改。

问题 3：如何查看某个 stash 的内容？

解答：你可以使用 git stash show 来查看 stash 中的更改：

git stash show stash@{0}

该命令会显示 stash@{0} 中包含的更改摘要。如果需要查看更详细的内容，可以添加 -p 参数：

git stash show -p stash@{0}

7. 总结与建议

git stash 是一个强大的工具，它帮助开发者在开发过程中临时保存工作进度，避免提交中断的工作或不完整的功能。合理利用 git stash 可以有效提升工作效率，尤其是在处理多个任务或需要频繁切换上下文时。

最佳实践建议：

• 频繁保存工作进度：当你需要切换任务时，使用 git stash 临时保存当前工作，避免丢失进度。
• 合理使用 stash 清理：定期使用 git stash list 检查和清理无用的 stash 条目，避免栈积累过多。
• 合适的 stash 策略：如果仅需保存特定更改或文件，可以使用 git stash -p 或 git stash --keep-index 精确保存需要的部分。

通过灵活运用 git stash，你可以更高效地管理开发过程中的多个任务，保持项目的高效推进。