Git Stash指定文件详解

1. 引言

在日常的软件开发过程中，我们经常需要切换分支进行不同的工作。然而，当我们在一个分支上进行了一部分工作，还没有完成，却需要切换到另一个分支时，Git 提供了 stash 命令来帮助我们保存未完成的更改，以便稍后可以回到当前分支继续工作。然而，有时候我们只希望保存部分文件的更改，而不是全部的更改，这时就需要使用 git stash 的参数来实现。

本文将详细介绍如何使用 git stash 的参数来指定具体的文件进行暂存。

2. Git Stash基本用法回顾

在开始讲解如何使用 git stash 的参数来指定文件之前，先回顾一下 git stash 的基本用法。

当我们需要切换到其他分支时，可以使用以下命令将当前分支上的未完成的更改暂存起来：

git stash

执行上述命令后，Git 会将当前分支上所有的未提交的更改（包括新增、修改和删除的文件）保存为一条 stash 记录，同时将工作区和暂存区的状态重置到上一次提交的状态。我们可以切换到其他分支，进行相应的工作。在切换回原分支时，可以使用以下命令还原之前保存的 stash 记录：

git stash apply

如果我们想查看保存的 stash 记录，可以使用以下命令：

git stash list

这样，我们就可以根据需要选择恢复特定的 stash 记录。

3. Git Stash指定文件的参数

有时候，我们不想将所有文件的更改都暂存起来，而只是想针对某些特定的文件进行暂存，以便稍后继续编辑。

在 Git 版本 2.13 之后的版本中，git stash 命令引入了一个新的参数 --patch（或 -p 的简写），它允许我们按照交互式地方式选择要暂存的文件补丁。该参数会打开一个文件补丁的选择菜单，我们可以选择要暂存的文件和需要保存到 stash 记录中的文件更改。

下面是使用 --patch 参数进行部分文件暂存的步骤：

步骤1：执行git stash命令并指定文件

git stash --patch

执行上述命令后，Git 会逐个文件地展示更改的补丁。对于每个文件，Git 会显示文件名以及文件更改的 diff。

步骤2：选择要暂存的文件

在文件补丁的选择菜单中，使用命令行输入相应的操作符来选择要暂存的文件：
– 输入 y 表示选择此文件，将其加入暂存区。
– 输入 n 表示不选择此文件，保留文件的更改。
– 输入 q 表示退出文件补丁的选择菜单，保存已选择的文件到 stash 记录。

步骤3：保存 stash 记录

完成对文件的选择后，Git 会继续展示其他文件的补丁。如果我们完成了所有文件的选择，可以按 q 退出补丁选择菜单，然后 Git 会提示我们输入 stash 记录的说明信息。输入相应的说明信息后，按 Enter 即可保存 stash 记录。

4. Git Stash指定文件示例

为了更好地理解和使用 git stash --patch 命令，我们来看一个示例。

假设我们有一个名为 example.py 的文件，其中包含以下内容：

def func1():
    print("This is function 1.")

def func2():
    print("This is function 2.")

def func3():
    print("This is function 3.")

现在，我们已经修改了 func1 和 func2 函数，并且想要先暂存 func1 函数的更改，然后才能切换到其他分支进行其他工作。

我们可以执行以下命令来指定暂存 example.py 文件中的 func1 函数的更改：

git stash --patch example.py

执行上述命令后，Git 会展示 example.py 文件中 func1 函数的差异，并提示选择相应的操作。

需要注意的是，如果 example.py 文件中还有其他的更改，我们可以按照上面的步骤选择要暂存的文件补丁。

5. 总结

通过本文的介绍，我们了解到了如何使用 git stash --patch 命令来指定具体的文件进行暂存。这对于我们在开发过程中需要切换分支，但又希望暂存部分文件更改的情况非常有用。