[Git] 放弃暂存区的修改

1 需求描述

• 在使用 Git 进行版本控制时，有时我们会在暂存区（staging area）中暂存了一些修改，但后来发现这些修改是不需要的，想要放弃这些修改并恢复到上一次提交的状态。Git 提供了几种方法来实现这一操作。

2 解决方法

方法 : 使用 git restore 命令

Git 2.23 版本引入了 git restore 命令，使得在一条命令中取消暂存和丢弃变得更加简单。使用这个命令，你可以取消对文件的暂存操作并恢复到上一次 commit 时的版本。

git --version# 此命令，2025-10-10 亲测
git restore --staged <file | dir>

上述命令中，<file | dir> 是你想要取消暂存的文件名。这条命令将会将文件从暂存区移除，但保留在工作区中。

方法 : 使用 git reset 命令

• 另一种常见的取消暂存和丢弃修改的方法是使用 git reset 命令。这个命令可以用来回退到之前的提交状态，同时可以丢弃暂存区和工作区的修改。

git reset HEAD <file>

上述命令中，<file>是你想要取消暂存的文件名。这条命令将会将文件从暂存区移除，并恢复到在最新的 commit 时的状态。

如果你想要彻底丢弃工作区的修改，可以使用 git reset 命令的 --hard 选项。

git reset --hard HEAD

请注意，这条命令将会丢弃工作区的所有修改，包括未暂存的和已经暂存的文件。

方法 : 使用 git checkout 命令

• 除了 git restore 和 git reset，你还可以使用 git checkout 来取消暂存和丢弃修改。这个命令可以用来恢复文件到最后一次提交的版本。

git checkout <file>

上述命令中，<file> 是你想要取消暂存和丢弃修改的文件名。这条命令将会丢弃工作区对该文件的修改，并将其恢复到最后一次提交的版本。

• 如果你想要取消暂存和丢弃工作区的所有修改，可以使用下面的命令：

git checkout

请注意，这条命令将会丢弃所有文件的修改，包括已暂存和未暂存的文件。

示例说明

假设我们有一个文件叫做 example.txt，其中包含了一些修改。现在让我们做几个示例来演示如何在一条命令中取消暂存和丢弃修改。

• 首先，我们将文件添加到暂存区：

git add example.txt

• 接着，我们对文件做了一些修改，但我们意识到这些修改是错误的。现在我们希望取消对文件的暂存并丢弃这些修改。我们可以使用 git restore 命令来实现：

git restore --staged example.txt

这条命令将会将文件从暂存区移除，并将其恢复到最后一次提交的版本2。

• 另外，如果我们希望彻底丢弃工作区对文件的修改，可以使用 git reset 命令的 --hard 选项：

git reset --hard HEAD example.txt

这条命令将会丢弃工作区对文件的所有修改，包括已经暂存的和未暂存的2。

• 最后，如果我们希望取消暂存和丢弃工作区的所有修改，可以使用 git checkout 命令：

git checkout

这条命令将会丢弃所有文件的修改，包括已暂存和未暂存的1。

通过以上几种方法，你可以轻松地撤销对文件的暂存和丢弃工作区的修改。根据你的具体需求，选择适合你的方法来处理变更。

Y 推荐文献

• [GIT] 解决：git status时有Untracked files(未跟踪的文件) - 博客园/千千寰宇

情况1：Add、Commit需提交的文件
情况2：自动忽略(.gitignore)关键文件
情况3：清理掉不需要的文件

• [GIT] 辨析/区别: git reset HEAD 与 git reset --hard HEAD | 版本回撤 - 博客园/千千寰宇 【推荐】

• [GIT] 辨析/区别: git add -u | git add -A | git add . [转载] - 博客园/千千寰宇

• [Git] 解决GIT冲突问题：git pull failed - 博客园/千千寰宇 【推荐】

git pull 时，有代码冲突

X 参考文献