1. 合并分支时最纠结的选择题:冲突文件到底听谁的
我打赌每个用过 Git 的人都被这种局面折磨过:你在 feature/login 分支上吭哧吭哧改了两周,终于要合回 main,结果 git merge 报出一串冲突,打开文件一看,<<<<<<< HEAD 和 >>>>>>> feature/login 把代码切成了两块。你很清楚,这个文件里该保留的是 feature/login 这边的版本,因为那边才是这次需求真正改动的代码,而 main 上的改动只是别人顺手加的注释。
这时候你会怎么做?
大多数人第一反应是打开编辑器,找到每个冲突标记,把当前分支的段落删掉,再把冲突标记清理干净,最后 git add 提交。小范围冲突这么干没问题,可一旦冲突文件有十几二十个,每个文件里还有五六处冲突地段,纯手工处理简直就是体力活。明明心里已经确定了"全部用被合并分支的代码",Git 却没有提供一个专门针对这种需求的一键命令吗?
其实是有的,而且不止一个。关键看你处在什么阶段、想作用到多大范围。本文要把这些方案彻底讲透:从文件级操作到全分支合并策略,再到那些容易把方向搞反的细节坑,全部过一遍。适合正在被代码冲突折磨、希望快速掌握"合并时以某一方为准"这种操作套路的开发者阅读,无论你用的是纯命令行、SourceTree 还是 VS Code 的 Git 插件,底层逻辑都是一套,看懂了到哪儿都好使。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 先搞懂冲突的本质,才知道"用被合并分支的代码"到底在说什么
2.1 一次合并冲突的完整生命周期
要有针对性地解决问题,先得知道问题是怎么发生的。Git 的合并(merge)本质上是一个三方合并过程:当前分支(HEAD)、被合并分支(要并进来的那个分支)、以及两个分支的共同祖先提交(merge base)。Git 会拿这三个版本去对比,如果共同祖先到两个分支的改动发生在不同的位置,Git 自动完成合并;如果两边改的是同一行甚至同一块内容,Git 没法判断哪个是"正确"的版本,于是把它标记为冲突,把决定权交给你。
举个例子,假设 main 分支和 feature/login 分支的公共祖先版本里有一行配置:
code复制timeout = 30
main 上有人改成了 timeout = 60,feature/login 上你改成了 timeout = 120。两边都是基于同一祖先做的修改,Git 完全猜不到公司最终想要哪个值,于是冲突出现。这个场景里,如果你作为合并的执行人,明确知道"这次要以 feature/login 的代码为准",那么你要做的事就是:让最终合并结果里,这个文件的内容完全等于 feature/login 分支上的样子。
这个目标听起来简单,但要注意一个关键细节:一个文件被标记为冲突,不代表整个文件的每一行都需要选边站。可能文件里只有一处冲突,其他部分 Git 已经自动合并好了。你"用被合并分支的代码",到底是指整个文件都换成对方的,还是只针对冲突片段用对方的?这两种需求的对应解法完全不一样,别搞混。
2.2 "整体换掉"和"冲突片段选边"是两种需求
我先说结论,后面逐个展开:
- 需求 A:冲突文件里,我只想保留被合并分支的版本,当前分支对这个文件的所有改动统统不要。 这种情况用
git checkout --theirs <file>最直接。 - 需求 B:整个文件大部分改动都要保留,只有冲突的那几段代码想采用被合并分支的写法。 这种情况更适合在合并时通过参数
-X theirs让 Git 自动选择,或者用git mergetool配合三方合并工具手动挑选。 - 需求 C:不仅冲突文件,整个分支合并过程中所有出现冲突的地方,全部无条件采用被合并分支。 这种属于"全面倒向一边",用
git merge -X theirs <branch>一次性搞定。
很多人一上来就找命令,结果发现 git checkout --theirs 和 git merge -X theirs 都听说过,但不知道区别,更不知道什么时候该用哪个。下面我用一次完整的实操把每个方案都走一遍。
3. 从零手工造一个冲突现场,再把它亲手解决掉
3.1 三分钟搭出实验仓库
纸上谈兵没意思,我建议你直接照着敲一遍。下面这套操作会在一个临时目录里造出一个真实的冲突现场,全程不碰你的真实项目,随便折腾不心疼。
bash复制# 创建一个实验目录并初始化仓库
mkdir git-merge-demo
cd git-merge-demo
git init
# 创建公共祖先版本
echo "timeout = 30" > config.ini
git add config.ini
git commit -m "init: add config.ini"
# 创建 feature 分支,并在 feature 上修改 config.ini
git checkout -b feature/login
echo "timeout = 120" > config.ini
git commit -am "feat: set login timeout to 120s"
# 切回 main 分支,修改同一个文件
git checkout main
echo "timeout = 60" > config.ini
git commit -am "chore: adjust login timeout to 60s"
执行完之后,仓库结构是这样的:main 和 feature/login 从同一个提交分岔,各自改动了 config.ini 的同一行。接下来执行:
bash复制git merge feature/login
你会看到 Git 的提示:
code复制Auto-merging config.ini
CONFLICT (content): Merge conflict in config.ini
Automatic merge failed; fix conflicts and then commit the result
