设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.50.1 无更改
-
2.50.0
2025-06-16
- 2.44.1 → 2.49.1 无更改
-
2.44.0
2024-02-23
- 2.43.1 → 2.43.7 无更改
-
2.43.0
2023-11-20
- 2.39.1 → 2.42.4 无更改
-
2.39.0
2022-12-12
- 2.38.1 → 2.38.5 无更改
-
2.38.0
2022-10-02
- 2.37.1 → 2.37.7 无更改
-
2.37.0
2022-06-27
- 2.30.1 → 2.36.6 无更改
-
2.30.0
2020-12-27
- 2.27.1 → 2.29.3 无更改
-
2.27.0
2020-06-01
- 2.23.1 → 2.26.3 无更改
-
2.23.0
2019-08-16
- 2.22.1 → 2.22.5 无更改
-
2.22.0
2019-06-07
- 2.10.5 → 2.21.4 无更改
-
2.9.5
2017-07-30
- 2.8.6 无更改
-
2.7.6
2017-07-30
-
2.6.7
2017-05-05
- 2.1.4 → 2.5.6 无更改
-
2.0.5
2014-12-17
概要
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
配置变量可用于默认启用此选项。
讨论
尽管 Git 会自动生成基本的提交消息,但强烈建议解释为什么要还原原始提交。此外,重复还原还原操作会导致主题行越来越冗长,例如 Reapply "Reapply "<original-subject>""。请考虑重新措辞,使其更短、更独特。
配置
本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同: