如何使用 git stash 保存并恢复未提交的修改？

Question

在日常开发中，经常遇到需要临时切换分支或拉取最新代码的情况，但当前工作尚未完成且不想立即提交。这时如何使用 `git stash` 保存并恢复未提交的修改成为常见需求。例如，在修改文件时收到紧急任务，需快速切换到其他分支处理。此时可运行 `git stash` 命令将更改暂存，随后通过 `git stash pop` 恢复更改并继续工作。如果存在多个 stash 记录，可通过 `git stash list` 查看，并用 `git stash apply stash@{x}` 恢复指定记录（x 为索引）。需要注意的是，`git stash pop` 恢复后会自动删除stash记录，而 `git stash apply` 仅恢复、保留记录。此外，若暂存包含未跟踪文件，需加参数 `--include-untracked` 或 `-u`。掌握这些技巧，能更高效地管理代码状态。

Answer 1

1. Git Stash 基础概念

在日常开发中，我们常常遇到需要切换分支或拉取最新代码的情况。然而，当前的工作可能尚未完成，又不想立即提交到版本库。这时，Git 提供了 `git stash` 命令来帮助开发者保存这些未提交的修改。

• `git stash`：将当前工作目录中的更改暂存。
• `git stash pop`：恢复最近一次暂存的内容，并从 stash 列表中删除该记录。
• `git stash apply`：恢复最近一次暂存的内容，但保留该记录在 stash 列表中。

使用这些命令可以帮助开发者快速切换任务，同时保持代码状态的整洁。

2. Git Stash 的常见用法

下面是一些常见的 `git stash` 使用场景和对应的操作：

场景	操作
保存当前工作状态	运行 git stash 将更改暂存。
查看所有 stash 记录	运行 git stash list 查看 stash 列表。
恢复指定 stash 记录	运行 git stash apply stash@{x} 恢复索引为 x 的记录。

如果需要处理未跟踪文件（如新增的文件），可以使用以下命令：

git stash --include-untracked

或者简写为：

git stash -u

3. 处理复杂情况的高级技巧

在实际开发中，可能会遇到更复杂的场景，例如多个 stash 记录的管理、stash 冲突的解决等。以下是具体的解决方案：

1. 当存在多个 stash 记录时，可以通过 git stash list 查看记录列表，并选择性地恢复某一条记录。
2. 如果 stash 恢复时出现冲突，Git 会提示冲突文件的位置，此时需要手动解决冲突后再继续操作。
3. 对于包含大量未跟踪文件的 stash，建议使用 --include-untracked 参数以确保所有更改都被保存。

下面是一个流程图，展示如何在紧急任务中使用 git stash：

mermaid
graph TD;
    A[开始开发] --> B[收到紧急任务];
    B --> C{是否有未提交修改};
    C --是--> D[运行 git stash];
    D --> E[切换到紧急任务分支];
    C --否--> E;
    E --> F[完成紧急任务];
    F --> G[切换回原分支];
    G --> H{是否需要恢复 stash};
    H --是--> I[运行 git stash pop];
    H --否--> J[结束];
    

4. 最佳实践与注意事项

在使用 `git stash` 时，需要注意以下几点以避免潜在问题：

• 定期清理不再需要的 stash 记录，可以运行 git stash clear 删除所有 stash。
• 在恢复 stash 时，确保当前分支的状态与 stash 保存时一致，以减少冲突的可能性。
• 如果 stash 包含重要数据，建议在恢复前将其应用到一个新的分支中进行测试。

此外，可以通过以下命令查看 stash 的具体内容：

git stash show -p stash@{x}

这有助于理解 stash 中的具体更改内容。