简体中文 ▾ 主题 ▾ 最新版本 ▾ git-revert 最后更新于 2.50.0

名称

git-revert - 还原现有的一些提交

概要

git revert [--[no-]edit] [-n] [-m <parent-number>] [-s] [-S[<keyid>]] <commit>…​
git revert (--continue | --skip | --abort | --quit)

描述

给定一个或多个现有提交,还原相关补丁引入的更改,并记录一些新的提交来记录这些更改。这要求你的工作区是干净的(与 HEAD 提交相比没有修改)。

注意:git revert 用于记录一些新的提交,以逆转早期提交(通常是错误的提交)的效果。如果你想丢弃工作目录中所有未提交的更改,你应该查看 git-reset[1],特别是其 --hard 选项。如果你想提取另一个提交中特定文件的版本,你应该查看 git-restore[1],特别是其 --source 选项。请谨慎使用这些替代方法,因为它们都会丢弃你工作目录中未提交的更改。

有关这三个命令之间的区别,请参阅 git[1] 中的“Reset、restore 和 revert”部分。

选项

<commit>…​

要还原的提交。有关拼写提交名称的更完整列表,请参阅 gitrevisions[7]。也可以给定提交集合,但默认不进行遍历,请参阅 git-rev-list[1] 及其 --no-walk 选项。

-e
--edit

使用此选项,git revert 将允许你在提交还原之前编辑提交消息。如果你从终端运行此命令,这是默认行为。

-m parent-number
--mainline parent-number

通常你无法还原合并,因为你不知道合并的哪一侧应该被视为主线。此选项指定主线的父提交编号(从 1 开始),并允许还原相对于指定父提交的更改。

还原一个合并提交表示你永远不希望合并带来的树更改。因此,后续的合并将只引入那些不是先前还原的合并的祖先提交所引入的树更改。这可能符合也可能不符合你的预期。

有关更多详细信息,请参阅 如何还原错误的合并 操作指南

--no-edit

使用此选项,git revert 将不会启动提交消息编辑器。

--cleanup=<mode>

此选项确定提交消息在传递给提交机制之前将如何清理。有关更多详细信息,请参阅 git-commit[1]。特别是,如果 <mode> 的值为 scissors,则在发生冲突时,scissors 将附加到 MERGE_MSG 后再传递。

-n
--no-commit

通常,此命令会自动创建一些提交,其提交日志消息说明哪些提交已被还原。此标志将还原指定提交所需的更改应用到你的工作区和索引,但不创建提交。此外,使用此选项时,你的索引不必与 HEAD 提交匹配。还原是针对索引的起始状态进行的。

当你需要连续还原多个提交对索引的影响时,此功能很有用。

-S[<keyid>]
--gpg-sign[=<keyid>]
--no-gpg-sign

GPG 签名提交。keyid 参数是可选的,默认为提交者身份;如果指定,它必须紧跟在选项后面,不能有空格。--no-gpg-sign 对于抵消 commit.gpgSign 配置变量和先前的 --gpg-sign 都很有用。

-s
--signoff

在提交消息末尾添加一个 Signed-off-by 尾部信息。有关更多信息,请参阅 git-commit[1] 中的 signoff 选项。

--strategy=<strategy>

使用给定的合并策略。此选项只能使用一次。有关详细信息,请参阅 git-merge[1] 中的 MERGE STRATEGIES 部分。

-X<option>
--strategy-option=<option>

将合并策略特定的选项传递给合并策略。有关详细信息,请参阅 git-merge[1]

--rerere-autoupdate
--no-rerere-autoupdate

在 rerere 机制重用当前冲突上的记录解决方案以更新工作树中的文件后,允许它也用解决方案结果更新索引。--no-rerere-autoupdate 是在用单独的 git add 将结果提交到索引之前,仔细检查 rerere 的作用并捕获潜在的错误合并的好方法。

--reference

不以“This reverts <full-object-name-of-the-commit-being-reverted>.”开头日志消息正文,而是使用“--pretty=reference”格式(参见 git-log[1])引用提交。revert.reference 配置变量可用于默认启用此选项。

序列器子命令

--continue

使用 .git/sequencer 中的信息继续进行中的操作。可用于在失败的 cherry-pick 或 revert 中解决冲突后继续。

--skip

跳过当前提交并继续序列中的其余部分。

--quit

放弃当前进行中的操作。可用于在失败的 cherry-pick 或 revert 后清除序列器状态。

--abort

取消操作并返回到序列前状态。

示例

git revert HEAD~3

还原 HEAD 中倒数第四个提交所指定的更改,并创建一个包含还原更改的新提交。

git revert -n master~5..master~2

还原从 master 中倒数第五个提交(包括)到倒数第三个提交(包括)所做的更改,但不创建任何包含还原更改的提交。还原操作只修改工作区和索引。

讨论

尽管 Git 会自动生成基本的提交消息,但强烈建议解释为什么要还原原始提交。此外,重复还原还原操作会导致主题行越来越冗长,例如 Reapply "Reapply "<original-subject>""。请考虑重新措辞,使其更短、更独特。

配置

本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同:

revert.reference

将此变量设置为 true 会使 git revert 的行为如同给定了 --reference 选项。

另请参阅

Git

Git[1] 套件的一部分

scroll-to-top