12.7.1 撤销未提交的本地修改

在Python编程或任何使用版本控制系统（如Git）的软件开发过程中，经常会遇到需要撤销或回滚本地未提交修改的情况。这些修改可能是在编码过程中的实验性改动、误操作或是临时决定放弃的更改。理解并熟练掌握撤销这些修改的技巧，对于维护代码库的整洁、避免不必要的合并冲突以及保护项目历史记录的清晰性至关重要。本章节将深入探讨如何在Git中撤销未提交的本地修改，包括使用Git命令行的不同方法来达到目的。

一、理解Git的工作区、暂存区和版本库

在讨论如何撤销未提交的本地修改之前，有必要先理解Git的三个基本区域：工作区（Workspace）、暂存区（Stage/Index）和版本库（Repository）。

• 工作区：即你的项目目录，包含了所有未提交的更改。这些更改可以是新添加的文件、对现有文件的修改或删除操作。
• 暂存区：也称为索引区，是一个中间状态，用于存放你即将提交到版本库的更改。通过git add命令，你可以将工作区的更改添加到暂存区。
• 版本库：是Git用来存储项目历史记录的数据库。通过git commit命令，你可以将暂存区的更改永久保存到版本库中，形成新的提交（Commit）。

二、撤销工作区的修改

如果你只是修改了文件但还没有执行git add将这些修改添加到暂存区，那么你可以使用以下方法撤销这些修改：

1. 使用git checkout -- <file>

这是撤销工作区单个文件修改的最直接方法。该命令会将指定文件回滚到最近一次提交时的状态，覆盖工作区的改动。

git checkout -- filename.py

注意：从Git 2.23版本开始，推荐使用git restore命令代替git checkout来恢复工作区的文件，以避免与检出分支的混淆。

git restore filename.py

2. 撤销所有未暂存的修改

如果你想要撤销工作区中所有未暂存的修改，可以使用git checkout .或git restore .（Git 2.23+）。这会撤销当前目录下所有文件的未暂存修改。

git checkout .
# 或者
git restore .

三、撤销暂存区的修改

如果你已经使用git add将修改添加到了暂存区，但还没有提交，那么撤销这些修改的方式会有所不同。

1. 撤销暂存区的单个文件

你可以使用git reset HEAD <file>命令将暂存区的文件移回工作区，但不改变工作区的修改内容。

git reset HEAD filename.py

然后，如果你想要撤销工作区的修改，可以结合使用git checkout -- <file>或git restore <file>。

2. 撤销所有暂存的修改

如果你想要撤销暂存区的所有修改，可以使用git reset命令不带任何文件参数，并指定为混合模式（默认模式），这将撤销所有暂存的修改，但保留工作区的修改。

git reset
# 或者更明确地
git reset HEAD

如果你希望完全撤销所有暂存和工作区的修改，回到最近一次提交的状态，可以使用git reset --hard HEAD，但请格外小心，因为这会丢失所有未提交的更改。

git reset --hard HEAD

四、使用git stash保存和恢复工作进度

有时候，你可能想要暂时保存当前的工作进度，以便稍后恢复，同时切换到另一个分支或任务上工作。这时，git stash命令就显得非常有用。

1. 保存当前工作进度

git stash

这会将所有未提交的修改（包括暂存区的）保存到一个临时的stash栈中，并让你的工作目录和暂存区变得干净。

2. 查看stash列表

git stash list

这会列出所有保存的stash项。

3. 应用stash

你可以随时通过git stash apply命令来恢复一个stash项，但请注意，默认情况下，stash项在应用后不会从stash栈中删除。

git stash apply stash@{0}
# 或者，如果只有一个stash项，直接使用
git stash apply

如果你希望在应用stash后从栈中删除它，可以使用git stash pop。

git stash pop

五、总结

撤销未提交的本地修改是Git版本控制中的一项基本且重要的技能。通过理解Git的工作区、暂存区和版本库的概念，以及熟练掌握git checkout/git restore、git reset和git stash等命令，你可以灵活地管理项目中的更改，避免不必要的混乱和错误。记住，在使用git reset --hard等可能丢失数据的命令时，务必谨慎行事，并考虑先备份重要数据。