Git Unstage：撤销暂存更改 – wiki大全

作者： /

Git Unstage：撤销暂存更改，掌控你的提交历史

在版本控制的世界里，Git 是开发者最强大的工具之一。它不仅能帮助我们跟踪代码的变化，还能让我们在提交（commit）前精细地准备每一次修改。Git 的“暂存区”（Staging Area），或者称作“索引”（Index），正是这种精细控制的核心。然而，有时我们会不小心将一些不应该被提交的更改添加到暂存区。这时，了解如何“unstage”（撤销暂存）这些更改就变得至关重要。

本文将深入探讨 Git 的暂存区机制，并详细介绍如何使用 git reset 命令来撤销暂存的更改，让你更好地掌控你的提交历史。

什么是 Git 暂存区？

在理解如何撤销暂存之前，我们首先需要明确暂存区的作用。

当你对工作目录中的文件进行修改后，这些修改并不会立即成为下一次提交的一部分。你需要使用 git add 命令将它们添加到暂存区。暂存区可以被看作是一个“排练区”或“准备区”。它允许你：

  1. 选择性提交： 你可以只暂存你想要提交的文件或文件中的特定部分，而不是提交所有修改。
  2. 组织提交： 将相关的更改组织在一起，形成一个逻辑上独立的提交。
  3. 预览提交： 在实际提交之前，你可以通过 git status 或 git diff --staged 命令查看哪些更改会被提交。

暂存区是工作目录（你正在编辑的文件）和版本库历史（已经提交的快照）之间的一个中间层。

为什么要撤销暂存？

在开发过程中，以下情况可能导致你需要撤销暂存的更改：

  • 误操作： 不小心 git add . 将所有文件都暂存了，但其中包含一些调试代码、不完整的功能或不应该提交的敏感信息。
  • 更改分组： 你想将一个大功能拆分成几个小提交，但在暂存时一次性添加了太多相关或不相关的更改。
  • 临时文件： 暂存了本应被 .gitignore 忽略但由于某些原因未被忽略的临时文件或编译产物。
  • 发现错误： 暂存后才发现代码中存在明显的错误，需要先修改再提交。

撤销暂存并不会丢失你的工作目录中的修改，它只是将文件从暂存区移回工作目录，让你有机会重新组织或修改。

如何撤销暂存：git reset 命令的妙用

Git 提供了 git reset 命令来撤销暂存的更改。最常用且最安全的选项是 git reset 后面不加任何参数，或者使用 --mixed 选项（这是默认行为）。

1. 撤销单个文件的暂存

如果你只暂存了一个文件，或者只想撤销某个特定文件的暂存，可以使用以下命令：

“`bash
git reset HEAD

或者更明确地使用 –mixed

git reset –mixed HEAD
“`

示例：

假设你修改了 index.html 和 style.css，并都暂存了。现在你想撤销 style.css 的暂存。

  1. 查看状态：
    bash
    git status
    # On branch main
    # Changes to be committed:
    # (use "git restore --staged <file>..." to unstage)
    # modified: index.html
    # modified: style.css
    （注意 Git 提示的 git restore --staged 是一个更现代、更直观的命令，效果相同，但 git reset HEAD <file> 历史悠久且同样有效。）

  2. 撤销 style.css 的暂存：
    bash
    git reset HEAD style.css

  3. 再次查看状态：
    bash
    git status
    # On branch main
    # Changes to be committed:
    # (use "git restore --staged <file>..." to unstage)
    # modified: index.html
    #
    # Changes not staged for commit:
    # (use "git add <file>..." to update what will be committed)
    # (use "git restore <file>..." to discard changes in working directory)
    # modified: style.css
    现在 style.css 已经从暂存区移除，回到了“Changes not staged for commit”的状态，而 index.html 仍然在暂存区。

2. 撤销所有已暂存的更改

如果你想撤销所有已暂存的更改，让暂存区恢复到上一次提交时的状态，可以使用以下命令：

“`bash
git reset HEAD

或者

git reset –mixed HEAD
“`

这个命令会将所有已暂存的更改从暂存区移回工作目录，使它们变为“Changes not staged for commit”。

示例：

承接上例，现在你决定连 index.html 也不想暂存了。

  1. 撤销所有暂存：
    bash
    git reset HEAD

  2. 再次查看状态：
    bash
    git status
    # On branch main
    # Changes not staged for commit:
    # (use "git add <file>..." to update what will be committed)
    # (use "git restore <file>..." to discard changes in working directory)
    # modified: index.html
    # modified: style.css
    #
    # no changes added to commit (use "git add" and/or "git commit -a")
    现在所有更改都回到了未暂存状态。

git restore --staged：一个更现代的选择

自 Git 2.23 版本起，引入了 git restore 命令，它提供了一个更清晰的接口来处理工作目录和暂存区。如果你只是想撤销暂存，git restore --staged 是一个更语义化、更易懂的选择：

  • 撤销单个文件暂存：
    bash
    git restore --staged <file_path>
  • 撤销所有文件暂存：
    bash
    git restore --staged .

git restore 将 git reset 在这方面的功能独立出来，使得命令的意图更加明确，减少了误操作的可能性，尤其是在 git reset 有多种模式（--soft, --mixed, --hard）且影响范围不同时。

总结

Git 的暂存区是一个强大的工具，它赋予了我们对提交内容前所未有的控制力。而 git reset HEAD <file_path> 或 git restore --staged <file_path> 则是我们纠正暂存失误、保持提交历史整洁的关键命令。

记住，git reset 在默认情况下（--mixed）是安全的，它只会影响暂存区，而不会修改你的工作目录中的文件内容。这使得你可以在不丢失任何工作的情况下，自由地调整你的提交内容。熟练掌握这些命令，将让你的 Git 工作流更加流畅高效，提交历史更加清晰可读。

滚动至顶部