如何将Git管理项目中的所有本地更改恢复到上一状态

技术背景

在使用Git进行项目开发时，我们经常会对文件进行各种修改。但有时我们可能需要将本地的更改恢复到之前的状态，例如修改出现错误、想要放弃当前的修改等。Git提供了多种命令来满足不同场景下的恢复需求。

实现步骤

恢复工作副本中的更改

如果要恢复对工作副本所做的更改，可以使用以下命令：

• 对于Git版本 < 2.23：

git checkout .

• 对于Git版本 >= 2.23：

git restore .

恢复暂存区（index）中的更改

如果要恢复已经添加到暂存区的更改，使用以下命令，但要注意这会将所有未推送的提交重置到 master：

git reset

恢复已提交的更改

若要恢复已经提交的更改，可以使用 git revert 命令：

git revert <commit 1> <commit 2>

删除未跟踪的文件和目录

• 删除未跟踪的文件：

git clean -f

• 删除未跟踪的目录：

git clean -fd

重新克隆仓库

如果想要完全重置项目，可以重新克隆仓库：

GIT=$(git rev-parse --show-toplevel)
cd $GIT/..
rm -rf $GIT
git clone ...

清理并重置

以下命令组合可以清理和重置项目：

git clean --force -d -x
git reset --hard

仅清理

仅清理未跟踪的文件和目录：

git clean --force -d -x

仅重置

仅重置工作副本和暂存区：

git reset --hard

使用 git stash

使用 git stash 可以移除所有本地更改，并在需要时恢复：

git stash
# 恢复更改
git stash apply

恢复到特定版本

可以使用 git log 查找与远程不同的本地提交版本，然后使用 git reset --hard 恢复到该版本：

git log
git reset --hard <commit hash>

恢复到远程分支状态

如果要将本地分支恢复到远程分支的状态，可以使用以下命令：

git fetch origin
git reset --hard origin/master
# 若使用 main 分支
git reset --hard origin/main

恢复单个文件的更改

如果只想恢复单个文件的更改，可以使用 git restore 命令：

git restore <file>

核心代码

以下是一个完整的脚本示例，用于将项目恢复到上一状态：

#!/bin/sh
git reset --hard
git clean -f -d
git checkout HEAD

最佳实践

• 在执行 git clean 命令之前，先使用 git clean -f -d -n 进行预览，避免误删重要文件。
• 对于不确定的操作，可以先使用 git stash 保存更改，待确认后再进行恢复或丢弃。
• 定期查看 git reflog，以便在需要时可以快速恢复到之前的状态。

常见问题

执行 git reset --hard 时出现文件锁错误

如果执行 git reset --hard 时出现类似 fatal: Unable to create '/directory/for/your/project/.git/index.lock': File exists. 的错误，可以手动删除 .git/index.lock 文件：

cd /directory/for/your/project/.git/
rm index.lock
git reset --hard HEAD

git reset 命令的误导性警告

git reset 命令在没有参数时默认是 git reset --mixed HEAD，只会影响暂存区，不会影响工作树或提交历史。只有结合提交引用（如 git reset --hard <commit>）才会改变本地仓库的提交历史。