Git 合并冲突别慌 一套流程从卡死到提交收尾

3 阅读5分钟

昨晚合分支又卡在冲突上了。其实这毛病每个月总要撞一回,但每次撞的时候还是会心慌一下,因为那个满屏的箭头符号看起来像文件坏了。这次干脆把整个流程在本机 git 2.55 上从头到尾跑了一遍,把每一步的真实输出都记下来,下次再撞直接照着走就行。

先搞明白冲突是怎么来的

冲突的本质是 git 不敢替你做决定。两个分支改了同一个文件的同一片区域,git 按三方合并的规矩拿你们的共同祖先做基准比对,发现两边都动了,它没法判断你想要哪边,就把文件停在一种特殊状态里等你。我实测的过程:建个仓库提交一版基础内容,拉出 feature 分支把文件改成 feature version 提交,回到 main 分支把同一个文件改成 master version 提交,然后 merge feature,输出很明确,自动合并 app.txt,然后一行大写冲突提示,最后一句自动合并失败,修复冲突然后提交结果。这时候退出码是 1,仓库进入了合并中断状态,不解决掉 commit 是过不去的。

第一件事永远是 git status 而不是打开文件瞎找

撞上冲突很多人的反应是立刻去翻文件,其实先看状态效率高得多。status 会告诉你三件关键事:当前在合并中、哪些路径未合并、以及两条出路提示,修完冲突跑 commit,或者不想要了用 merge 加 abort 两个横杠参数放弃合并。我实测里 Unmerged paths 下面写着 both modified 冒号 app.txt,both modified 就是内容冲突;后面还会遇到另一种写法 deleted by them,那是改删冲突,处理方式不一样。看清楚清单再动手,一个仓库十几个文件冲突的时候,这个清单就是你的任务列表。

看懂文件里的三行标记,别把等号当分隔符乱删

打开冲突文件会看到三行标记,小于号开头那行后面跟着 HEAD,表示到等号行为止是当前分支这边的版本;单独一行七个等号是分界线;大于号开头那行标注着对方分支名,等号到这行之间是对方版本。两个大坑要记:第一,等号不是让你保留的,它和前后两行标记都要删干净,留一个在文件里,add 的时候 git 不报错,但这份文件会带着垃圾标记直接进版本库,前端页面当场表演原始代码;第二,解决冲突不是二选一,你可以留这边的、留那边的、也可以把两边内容整合成新的写法,git 只要求标记消失,内容怎么定是你的事。

想知道对方为什么改这一段,三个版本都在仓库里存着

合并中断的时候仓库里其实存着文件的三个版本,用 show 命令加冒号数字冒号路径的写法能分别取出来:冒号 1 是共同祖先的版本,冒号 2 是当前分支的版本,冒号 3 是对方分支的版本。我实测输出,祖先版本是 line1,这边是 master version,那边是 feature version,三方对比一眼看出对方到底是加了什么。还有个更直接的命令,log 加两个横杠 merge 参数,只显示跟这个冲突文件相关的两边分支上的提交,我跑出来正好是两边的提交记录各一条,谁改的为什么改一目了然。判断不了怎么合的时候,先看历史再动手,比闭着眼睛选一边靠谱。

解决三步走:改文件、add、commit,中断了可以用 abort 逃

标准收尾就三步。把文件里的标记处理干净改成人想要的最终内容;git add 这个文件,告诉 git 我解决完了,我实测 add 完再跑 status,提示会从修复冲突变成所有冲突已解决但你仍在合并中,让你用 commit 收尾;最后 git commit,git 会自动生成一条合并提交,这个提交有两个父提交,历史图里能看到分叉又汇合的样子。如果解到一半发现方向错了不想要这次合并了,git merge 加 abort 两个横杠参数能一步回到合并前的干净状态,我实测 abort 之后文件立刻恢复成本分支的内容,status 显示工作区干净,什么痕迹都不留。这个逃生舱放心用,它的意义就是让你随时能反悔。

改删冲突没有等号标记,处理逻辑完全不同

还有一种冲突不会给你三行标记。一边分支删了某个文件,另一边改了同一个文件,合并的时候报 modify 斜杠 delete 冲突,提示文件在对方分支被删而在当前分支被修改。我实测此时 status 里写的是 deleted by them 冒号文件名,文件本身留在工作区。这时候没有标记可删,你要做的只有一个决定:这个文件到底还要不要。要就 git add 把它留下来,不要就 git rm 删掉,然后照常 commit。很多教程只讲内容冲突不讲这种,新手撞上会找不到等号标记以为出了什么灵异事件。

顺手记一句

整套流程压缩成一句话:撞冲突先 status 看清单,文件里三行标记加两边内容读懂再改,改干净 add 标记解决,commit 收尾,反悔用 abort。工具层面系统自带的 log 加 merge 参数够用,图形化 merge 工具按需上。冲突不是事故,它恰恰说明 git 在替你守住两边的劳动成果,读懂它比绕开它划算。