主线 · 第 4 / 8 篇
· 约 8 分钟
两条线怎么合到一起:快进、合并提交、冲突和变基
能顺着走到的分支直接快进,分了叉的才做三方合并,生成有两个父提交的合并提交。冲突是两边改了同一处,Git 把三个版本放进暂存区等人决定。变基不合并,而是把提交在新的基础上重放一遍,换来一条直线和一批新哈希。
合并时常见的几个疑问:为什么有时合并只说了一句 Fast-forward,有时却多出一个 Merge branch ... 的提交?冲突是不是 Git 出了错?变基和合并到底差在哪,为什么总有人说变基危险?把前几篇的模型带进来,这几件事都能落到“提交图”和“引用”上。
先说明几个词。合并(merge)是把另一条分支的工作并进当前分支。共同祖先(merge base)是两条分支在提交图上最近的公共提交。变基(rebase)是把一串提交换一个起点重新做一遍。
能顺着走到的,直接快进
接着用前几篇的演示仓库,main 在 second(86c0fab)。从 main 拉出 hotfix 分支,提交一次 b780faa,再回到 main 合并:
$ git merge hotfix
Updating 86c0fab..b780faa
Fast-forward
合并之后 main 和 hotfix 都指向 b780faa,没有新提交。Pro Git 的解释是:如果顺着一条分支走下去能到达另一条分支,合并时没有需要解决的分歧,Git 只是把指针往前推,这叫快进(fast-forward)。
所以快进本质上只是改了 main 的指向,和上一篇里“提交时分支往前走”是同一件事。
分了叉,才需要合并提交
再从 main 拉出 feature,在上面加 feature.txt;同时在 main 上加 notes.txt。两边各有一个对方没有的提交,从哪一边都走不到另一边,快进不了。
这时 Git 做三方合并:拿两个分支末端的快照,加上它们的共同祖先 b780faa,算出合并后的结果,存成一个新快照,再新建一个提交指向它。Pro Git 说,这个合并提交的特别之处在于它有不止一个父提交:
$ git cat-file -p HEAD
tree 2aa7451e261096b7823d090ec1d784adab71530a
parent aece7f31dca4bb206a93fd495651ea4647172a16
parent 63d51966c3a942cd22cf780113f4f00c4d2de29c
...
Merge branch 'feature'
两个 parent,一个是 main 原来的末端 aece7f3,一个是 feature 的末端 63d5196。第一篇说历史是一张图而不是一条线,指的就是这种提交。截取 git log --oneline --graph 的前几行:
* c81d122 Merge branch 'feature'
|\
| * 63d5196 add feature.txt
* | aece7f3 add notes.txt
|/
* b780faa fix docs
“三方”的三方,就是两个末端加一个共同祖先。拿共同祖先作参照,Git 才知道每一边各改了什么。
冲突从哪里来
git-merge 文档讲得很清楚:相对共同祖先,一边改了某一处、另一边没动,这种改动直接采用;两边改了同一处、改得又不一样,Git 不能随便挑一边,只能把两边的改动都留下,让人来决定。这就是冲突。两边改成一模一样的内容,Git 会直接合并。
在演示仓库里,共同祖先的 README.md 第二行是 world。topic 分支把它改成 git,main 把它改成 there,然后合并:
$ git merge topic
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Automatic merge failed; fix conflicts and then commit the result.
这时合并停在一半。按文档,HEAD 不动,仍是 main 的 6c79e30;另外写一个 MERGE_HEAD 指向 topic 的 8b2f10c。没冲突的路径照常更新,有冲突的路径,暂存区会同时记下三个版本:
$ git ls-files -u
100644 94954abda49de8615a048f8d2e64b5de848e27a1 1 README.md
100644 c4c04173748f9107f27a8a2e4007ec50c88da299 2 README.md
100644 23509e04e6b9cf5b51d633f47f7d459c5fc822fc 3 README.md
第二篇提过暂存区那一列阶段号平时是 0,这里就是它不为 0 的时候。阶段 1 是共同祖先的版本,94954ab 正是第二篇里那个 hello、world 两行的数据对象;阶段 2 是 HEAD 的版本,内容是 there;阶段 3 是 MERGE_HEAD 的版本,内容是 git。git status --short 显示 UU README.md,意思是两边都改了、尚未合并。
工作区里的文件则带上冲突标记,======= 前面是当前分支这一边,后面是要并进来的那一边:
hello
<<<<<<< HEAD
there
=======
git
>>>>>>> topic
解决冲突,就是重写暂存区那一条
解决的步骤是:把文件改成想要的样子,删掉标记,再 git add。演示里改成 git and there,add 之后,git ls-files -s 里只剩一条阶段号为 0 的记录。三个版本合成了一个,暂存区又能转成一棵树了。最后 git commit,得到的合并提交同样有两个父提交,6c79e30 和 8b2f10c。
如果冲突太乱,想从头来过,git merge --abort 会尽量恢复到合并开始之前的状态。
这里有两个容易误解的地方。第一,冲突不是出错,而是 Git 缺少决定所需的信息:两边都说了话,它不知道该听谁的。第二,没有冲突也不等于合并结果一定对。Git 只按文本的“同一处”判断,两边改了不同的地方、合起来却互相矛盾,它不会报告。合并之后该跑的测试还得跑。
变基:把提交换个起点重放
变基换一种方式处理分叉。按 git-rebase 文档的简化描述,它做四件事。先列出当前分支上、目标分支里还没有的提交。再以游离 HEAD 的方式切到目标分支。然后把这些提交按顺序一个个重放,类似逐个 cherry-pick(把单个提交带来的改动在当前位置再做一次)。最后让当前分支指向重放出来的最后一个提交。
演示仓库里,topic2 有两个提交 966e20f、488fe29,main 上又多了一个 4764b2c。在 topic2 上执行 git rebase main 之后:
$ git log --oneline --graph -3
* e64e01d topic2: t2
* 423147d topic2: t1
* 4764b2c main: m
历史成了一条直线,两个提交都换了哈希:488fe29 变成了 e64e01d。原因在第一篇:父提交换了,提交内容就变了,哈希也就变了。这两个是新提交,不是原来的提交挪了位置。旧的 488fe29 仍在,ORIG_HEAD(变基这类操作前,Git 把原位置记在这个名字里)记着它,git cat-file -t 查出来还是 commit。
之后在 main 上 git merge topic2,就是一次快进。再拿同样的两条分支做一次普通合并,对比两种结果的树:都是 6ac963f。Pro Git 也这样总结:无论变基还是三方合并,整合后指向的快照是一样的,只是提交历史不同。
变基也可能冲突。<<<<<<< HEAD 一侧是目标分支加上已重放的结果,另一侧是正在重放的提交,不能直接套用原分支的左右关系。改好并 git add 后,用 git rebase --continue 继续,不要另做 commit;放弃则用 git rebase --abort。
合并还是变基
两种做法的结果快照相同,区别全在历史上。合并保留分叉的真实经过,多一个合并提交;变基得到一条直线,代价是改写了这些提交。
Pro Git 给变基定了一条准则:如果提交已经存在于自己的仓库之外,别人可能基于它们开发,就不要变基。变基的实质是丢弃一些现有提交,再新建内容一样但哈希不同的提交。别人手上还是旧提交,再整合时就会乱。还没推送、只在本地的分支,用变基整理没有问题;已经推送、别人可能在用的,就交给合并。推送和改写历史的边界,第五篇和第八篇再细讲。
审 AI 的 Git 操作时,先分清是快进还是合并提交。遇到冲突,不只看标记是否删净,还要核对最终保留的内容。直接 git show 合并提交通常看不到完整差异,需要和两个父提交分别比。变基会换掉提交哈希;如果改写了已经推送的历史,接下来的强推必须先确认协作边界。
参考资料
- Pro Git:分支的新建与合并:快进,三方合并,合并提交有不止一个父提交,冲突的标记和解决。
- Pro Git:变基:变基的原理,最终快照与合并相同,变基的风险和准则。
- git-merge:冲突时 HEAD、MERGE_HEAD 和暂存区的三个阶段,冲突如何呈现,
--abort。 - git-rebase:变基的四个步骤,冲突时的
--continue与--abort,ORIG_HEAD。 - git-status:短格式里
UU表示两边都修改、尚未合并。
本文涉及的知识点
8 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点
本节知识点
本节知识点