Skip to main content

此版本的 GitHub Enterprise Server 已于以下日期停止服务 2024-09-25. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

关于 Git 变基

git rebase 命令用于轻松更改一系列提交,修改存储库的历史记录。 您可以重新排序、编辑提交或将提交压缩到一起。

通常,你会使用 git rebase 来:

  • 编辑之前的提交消息
  • 将多个提交合并为一个
  • 删除或还原不再必要的提交

Warning

由于更改提交历史记录可能会给其他人使用存储库造成困难,因此如果提交已经推送到存储库,建议不要执行提交变基。 若要了解如何安全地变基,请参阅 关于拉取请求合并

对分支变基提交

要对另一个分支与当前分支状态之间的所有提交变基,可以在 shell(Windows 的命令提示符或者 Mac 和 Linux 的终端)中输入以下命令:

git rebase --interactive OTHER-BRANCH-NAME

对某一时间点变基提交

要变基当前分支中最近的几个提交,可以在 shell 中输入以下命令:

git rebase --interactive HEAD~7

变基时可用的命令

变基时有六个命令可用:

pick
pick 只表示包含提交。 在变基进行时重新排列 pick 命令的顺序会更改提交的顺序。 如果选择不包含提交,应删除整行。
reword
reword 命令类似于 pick,但在使用后,变基过程就会暂停,让你有机会改变提交消息。 提交所做的任何更改都不受影响。
edit
如果选择 edit 提交,你将有机会修订提交,也就是说,可以完全添加或更改提交。 您也可以创建更多提交后再继续变基。 这样您可以将大提交拆分为小提交,或者删除在提交中执行错误更改。
squash
此命令可用于将两个或以上的提交合并为一个。 下面的提交压缩到其上面的提交。 Git 让您有机会编写描述两次更改的新提交消息。
fixup
这类似于 squash,但要合并的提交丢弃了其消息。 提交只是合并到其上面的提交,之前提交的消息用于描述两次更改。
exec
这可让您对提交运行任意 shell 命令。

使用 git rebase 的示例

无论使用哪个命令,Git 都将启动默认文本编辑器,并且打开一个文件,其中详细说明了所选范围的提交信息。 该文件类似于:

pick 1fc6c95 Patch A
pick 6b2481b Patch B
pick dd1475d something I want to split
pick c619268 A fix for Patch B
pick fa39187 something to add to patch A
pick 4ca2acc i cant' typ goods
pick 7b36971 something to move before patch B

# Rebase 41a72e6..7b36971 onto 41a72e6
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#
# If you remove a line here THAT COMMIT WILL BE LOST.
# However, if you remove everything, the rebase will be aborted.
#

从上到下分解此信息,我们可以看出:

  • 列出了七个命令,表示从起点到当前分支状态之间有七处更改。
  • 您选择要变基的提交按最早更改(顶部)到最新更改(底部)的顺序存储。
  • 每行列出一个命令(默认为 pick)、提交 SHA 和提交消息。 整个 git rebase 过程以这三列的操作为中心。 做出的更改将变基到存储库。
  • 提交后,Git 会告知正在处理的提交范围 (41a72e6..7b36971)。
  • 最后,Git 会提供一些帮助,告知在变基提交时可用的命令。

其他阅读材料