Git Revert Commit 实战：常见操作场景解析

在软件开发过程中，版本控制是至关重要的环节。Git 作为目前最流行的分布式版本控制系统，提供了强大的功能来管理代码的变更历史。其中，git revert 命令是一个非常有用的工具，它允许开发者安全地撤销之前的提交，同时保留完整的历史记录。与 git reset 不同，git revert 通过创建新的提交来“反转”之前的更改，而不是直接修改提交历史。这使得 git revert 成为在共享仓库中撤销提交的首选方法。

本文将深入探讨 git revert 命令，并通过一系列实战场景来解析其用法、原理、优势以及需要注意的事项。

1. git revert 的基本原理

git revert 命令的核心思想是创建一个新的提交，这个新提交的内容与需要撤销的提交内容相反。例如，如果一个提交添加了一个文件，那么 git revert 这个提交将会创建一个删除该文件的新提交。如果一个提交修改了某一行代码，git revert 将会创建一个将该行代码恢复到原始状态的新提交。

图示：

假设我们有以下提交历史：

A -- B -- C -- D (master)

其中，提交 C 引入了一个错误。如果我们想撤销提交 C，使用 git revert C 后，提交历史会变成：

A -- B -- C -- D -- C' (master)

C' 是一个新的提交，它的内容与 C 相反。C 仍然存在于历史记录中，但 C' 的引入使得代码库的状态回到了 B 之后的状态。

命令格式：

bash
git revert <commit-hash>

<commit-hash> 是要撤销的提交的 SHA-1 哈希值。你可以使用 git log 命令来查看提交历史并找到相应的哈希值。

2. 常见操作场景

2.1 撤销单个提交

这是 git revert 最常见的用法。假设你发现最近的一次提交引入了一个 bug，需要立即撤销。

步骤：

1. 找到要撤销的提交的哈希值：

   bash
git log

   在输出中找到目标提交，复制其哈希值（例如 a1b2c3d4）。
   2. 执行 git revert 命令：

   bash
git revert a1b2c3d4

   Git 会自动创建一个新的提交，并打开你的默认文本编辑器，让你编辑提交信息。
   3. 编辑提交信息（可选）：

   默认的提交信息会包含 “Revert <原提交信息>”。你可以根据需要修改。
   4. 保存并关闭编辑器：

   Git 会完成撤销操作，并创建一个新的提交。
   5. 推送到远程仓库（如果需要）：
   git push origin <branch_name>

2.2 撤销多个连续的提交

如果你需要撤销一系列连续的提交，可以使用 git revert 结合提交范围。

步骤：

1. 确定提交范围：

   使用 git log 找到要撤销的提交范围的起始和结束提交的哈希值。
   2. 执行 git revert 命令，使用 .. 表示范围：

   bash
git revert <start-commit-hash>..<end-commit-hash>
   例如：
   bash
git revert a1b2c3d4..e5f6g7h8
   这将撤销从 a1b2c3d4（不包括）到 e5f6g7h8（包括）之间的所有提交。Git 会为每个提交创建一个对应的撤销提交。

注意：
* git revert 会按照从旧到新的顺序依次撤销提交。这是为了避免潜在的冲突。
* 使用这种方式撤销多个提交时，你可能需要多次编辑提交信息，并解决可能出现的冲突。

2.3 撤销多个不连续的提交

撤销不连续的提交稍微复杂一些，但仍然可行。你需要逐个撤销每个提交。

步骤：

1. 使用 git log 找到所有需要撤销的提交的哈希值。

2. 按照从旧到新的顺序，依次执行 git revert 命令：

   bash
git revert <commit-hash-1>
git revert <commit-hash-2>
git revert <commit-hash-3>
...

注意： 这种方法可能会导致大量的提交信息编辑和潜在的冲突解决。

2.4 撤销合并提交（Merge Commit）

撤销合并提交需要特别注意，因为合并提交有两个父提交。你需要指定要撤销到哪个父提交。

步骤：

1. 使用 git log --oneline --graph 查看提交历史，找到合并提交的哈希值。

2. 使用 -m 选项指定父提交编号：

   bash
git revert -m <parent-number> <merge-commit-hash>

   • <parent-number>：指定要撤销到的父提交编号。通常，1 表示主分支（合并到的分支），2 表示被合并的分支。
   • 你可以通过 git log --oneline --graph <merge-commit-hash> 查看父提交的顺序来确定编号。

   例如，如果你想撤销合并提交，并回到主分支的状态，可以使用：

   bash
git revert -m 1 <merge-commit-hash>
   3. 编辑提交信息，保存并关闭编辑器.
   4. 推送变更到远程仓库（如果需要）.

2.5 使用 --no-commit 选项

git revert 默认会自动创建一个新的提交。如果你想先查看撤销的效果，或者想将多个撤销操作合并成一个提交，可以使用 --no-commit 选项。

步骤：

1. 执行 git revert 命令，加上 --no-commit 选项：

   bash
git revert --no-commit <commit-hash>

   这会执行撤销操作，但不会自动创建提交。更改会暂存在暂存区（staging area）。
   2. 检查更改：

   使用 git status 和 git diff 查看更改是否符合预期。
   3. 手动提交：

   如果你对更改满意，可以使用 git commit 手动创建提交。

示例： 撤销多个提交并合并成一个提交

bash
git revert --no-commit <commit-hash-1>
git revert --no-commit <commit-hash-2>
git commit -m "Revert commits 1 and 2"

2.6 解决冲突

在执行 git revert 时，可能会遇到冲突。这通常发生在要撤销的提交修改了后续提交也修改过的同一部分代码时。

步骤：

1. Git 会提示冲突：

   当发生冲突时，Git 会停止 revert 操作，并在输出中显示冲突的文件。
   2. 手动解决冲突：

   打开冲突的文件，你会看到类似以下的标记：

   “`
   <<<<<<< HEAD
   当前分支的代码
   =======
   要撤销的提交的代码

   
   “`

   你需要手动编辑文件，选择保留哪部分代码，或者将两部分代码合并。删除 <<<<<<<, =======, >>>>>>> 等标记。
   3. 标记冲突已解决：

   解决完所有冲突后，使用 git add 命令将修改后的文件标记为已解决：

   bash
git add <conflicted-file>
   4. 继续 revert 操作：

   bash
git revert --continue

   Git 会继续 revert 操作，并打开编辑器让你编辑提交信息。
   5. 如果想放弃 revert 操作：

   bash
git revert --abort
   这会取消 revert 操作，并将代码库恢复到执行 git revert 之前的状态。

3. git revert 与 git reset 的比较

git revert 和 git reset 都可以用来撤销提交，但它们的工作方式和适用场景有很大不同。

特性	git revert	git reset
工作方式	创建一个新的提交来“反转”之前的更改。	直接修改提交历史，将 HEAD 指针移动到指定的提交。
历史记录	保留完整的提交历史。	可以删除或修改提交历史（--hard 选项）。
安全性	更安全，因为它不会修改现有的提交历史。	如果使用 --hard 选项，可能会丢失未提交的更改或删除重要的提交历史。
适用场景	在共享仓库中撤销提交的首选方法。	适用于本地仓库的撤销操作，或者在确定没有其他人依赖于你要修改的提交历史时，也可以用于共享仓库。
对远程仓库的影响	创建新的提交，需要推送到远程仓库。	如果使用 --hard 选项修改了已推送到远程仓库的提交历史，需要使用 git push --force 强制推送（非常危险，除非你非常确定自己在做什么）。

总结：

• git revert 是“安全”的撤销操作，因为它不会修改提交历史。它适用于任何场景，尤其是在共享仓库中。
• git reset 是“危险”的撤销操作（尤其是在使用 --hard 选项时），因为它会直接修改提交历史。它主要用于本地仓库，或者在确保没有其他人依赖于你要修改的提交历史的情况下使用。

4. 最佳实践和注意事项

• 在执行 git revert 之前，确保你的工作目录是干净的。 使用 git status 检查是否有未提交的更改。
• 在撤销合并提交时，务必使用 -m 选项指定正确的父提交编号。
• 如果遇到冲突，仔细解决冲突，确保代码的正确性。
• 在推送到远程仓库之前，仔细检查 git revert 的结果。
• 不要轻易使用 git reset --hard 来修改已推送到远程仓库的提交历史。 这可能会导致其他开发者的工作丢失或混乱。
• ** 撤销操作后，及时与团队成员沟通。** 告知相关变更。

5. 总结

git revert 是 Git 中一个强大而安全的命令，用于撤销之前的提交。通过创建新的提交来“反转”更改，git revert 保持了完整的提交历史，使其成为共享仓库中撤销提交的首选方法。本文详细介绍了 git revert 的原理、常见操作场景、与 git reset 的比较，以及最佳实践和注意事项。掌握 git revert 命令，可以帮助你更好地管理代码版本，并在出现错误时安全地回滚更改。 熟练使用 git revert，可以让你在版本控制的世界里更加游刃有余！