12．7．1 撤销未提交的本地修改-Python编程轻松进阶(四)

当前位置:　首页>> 技术小册>> Python编程轻松进阶(四)

### 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>`

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

```bash
git checkout -- filename.py
```

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

```bash
git restore filename.py
```

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

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

```bash
git checkout .
# 或者
git restore .
```

#### 三、撤销暂存区的修改

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

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

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

```bash
git reset HEAD filename.py
```

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

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

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

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

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

```bash
git reset --hard HEAD
```

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

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

##### 1. 保存当前工作进度

```bash
git stash
```

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

##### 2. 查看stash列表

```bash
git stash list
```

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

##### 3. 应用stash

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

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

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

```bash
git stash pop
```

#### 五、总结

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

该分类下的相关小册推荐：

Python机器学习基础教程(上)

Python合辑12-面向对象

Python自动化办公实战

Python爬虫入门与实战开发(上)

Python与办公-玩转PPT

Python编程轻松进阶(二)

Python合辑9-判断和循环

Python3网络爬虫开发实战(上)

Python编程轻松进阶(五)

Python合辑1-Python语言基础

Python机器学习基础教程(下)

Python3网络爬虫开发实战(下)