通常,你会使用 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 会提供一些帮助,告知在变基提交时可用的命令。
延伸阅读
- "在命令行中使用 Git rebase"
- Pro Git 书籍中的“Git 分支”一章
- Pro Git 书籍中的“交互式变基”一章
- 使用变基压缩提交
- GitHub Desktop 文档中的“在 GitHub Desktop 中同步分支”