分支、合并与冲突
本合集目录
本章目录
单册说明:本文件是卷 3 的第 2 章,可独立阅读。前置:第 1 章(三区与快照)。本章讲清"分支只是一张便签",以及两条岔路合回来时,Git 什么时候能自动合、什么时候要你动手。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 3 · 工程化与版本控制(第 2 / 7 章) |
| 前置章节 | 3.1 Git 的心智模型 |
| 本章产出 | 一条功能分支 · 一次真实冲突与逐行解决 · 一张 merge / rebase 取舍表 |
| 对应代码 | dudao/app.js(在 feature/tag-filter 分支上改标签筛选) |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 看到 <<<<<<< 不慌,能说出两边各是谁、删哪半、删完还要做什么 |
3.2.1 一句话结论:分支是一张写着哈希的便签
上一章说过,.git/refs/heads/main 这个文件里只有一行内容:某个提交的 40 位哈希。创建分支就是新建一个这样的文件,写上和当前一样的哈希。 不复制目录、不复制文件、不占额外空间——所以 Git 里开分支的成本几乎是零,快到你可以为一个小改动单开一条。
真实失败场景:你不信这件事,于是手工复制了整个 dudao 文件夹改名 dudao-标签筛选,在里面改了两天。现在两个目录都有改动,你想合起来,只能靠眼睛一行行比。这就是没有分支的世界:合并靠人肉,冲突靠猜。
更麻烦的是"哪个才是真的"。两个文件夹看起来一样,只有修改时间不同;你把 A 里的函数贴到 B,B 里那段旧代码还在,浏览器跑起来两个同名函数,后加载的覆盖前面的——页面看着能用,但行为是随机的。分支把这件事变成一个有明确答案的问题:谁是主线、谁是新功能、合并时以谁为基准,全写在 ref 里。
3.2.2 原理:指针怎么移动,两条岔路怎么合
① 分支操作只有三个动作
| 动作 | 命令(现行写法) | 旧写法 | 背后发生了什么 |
|---|---|---|---|
| 建分支并切过去 | git switch -c feature/tag-filter |
git checkout -b ... |
新建 ref 文件 + HEAD 改指向它 |
| 切到已有分支 | git switch main |
git checkout main |
只改 HEAD,工作区文件被换成目标快照 |
| 删分支 | git branch -d feature/tag-filter |
同 | 删掉 ref 文件,提交本身还在 |
switch 和 restore 是后来从 checkout 里拆出来的:checkout 一个分支和 checkout 一个文件,语义完全不同却共用一条命令,害了太多人。本书统一用 switch 切分支、restore 还原文件,checkout 只在看旧资料时认得就行。
② 两条岔路:fast-forward 与三方合并
设 main 在提交 C1,你开了 feature 分支改到 C2,同时 main 没动。这时合并 feature:
合并前: C1 ← main
\
C2 ← feature
合并后: C1 —— C2 ← main, feature
Git 只需要把 main 这张便签挪到 C2,不产生新提交,历史是一条直线。这叫 fast-forward(快进)。判断条件很硬:目标分支是当前分支的直系后代。
如果 main 在你开发期间也前进到了 C3(比如你顺手修了个错别字),两条线就分叉了。Git 会找 C1(共同祖先)、C2、C3 做一次三方合并,生成一个新提交 C4,它有两个父提交:
C1 ── C2 ← feature
\ ↓
C3 ── C4 ← main(C4 有两个父提交:C3 与 C2)
| 类型 | 何时发生 | 会不会产生新提交 | 历史形状 |
|---|---|---|---|
| fast-forward | 目标分支没有新提交 | 不会 | 直线 |
| 三方合并(merge commit) | 两边都有新提交,且改动不重叠 | 会,两个父提交 | 分叉再汇合 |
| 冲突 | 两边改了同一文件的同一区域 | 先不合,等人处理 | 暂停在合并中 |
第三种情况不是"出错",是 Git 在说:这段内容有两种合理版本,我没有资格替你选。
③ 冲突标记怎么读
冲突时 Git 会往文件里写三段标记:
<<<<<<< HEAD
btn.className = tag === state.activeTag ? 'tag tag--active' : 'tag';
=======
btn.className = state.activeTag === tag ? 'tag is-active' : 'tag';
>>>>>>> feature/tag-filter
| 标记 | 含义 |
|---|---|
<<<<<<< HEAD |
以下是你当前所在分支(合并时是 main)的版本,到 ======= 为止 |
======= |
两个版本的分界线 |
>>>>>>> feature/tag-filter |
以上是被合并进来那条分支的版本 |
处理冲突只有四步,顺序不能乱:
- 读:搞清两边各自的意图(不是"哪边新",而是"哪边对")。
- 改:把标记和不要的那半删掉,留下最终内容。三个标记必须全部消失——包括
=======。 - 标记已解决:
git add这个文件。这一步才是告诉 Git"我处理完了"。 - 收尾:
git commit(merge 场景下信息已预填,直接保存即可)。
判断"哪边对"的方法:如果两边只是写法不同,选和项目其余代码风格一致的那版;如果两边是不同功能,通常两边都要,把它们按逻辑拼起来,而不是二选一。
④ merge 与 rebase:两种"合"的哲学
rebase 不是合并,是把你的提交摘下来,改写到另一条线的末端,让历史看起来像"你一直在最新代码上开发"。
| 维度 | merge |
rebase |
|---|---|---|
| 历史形状 | 保留分叉,真实 | 拉成直线,好看 |
| 是否改写提交 | 不改 | 改(哈希全变) |
| 冲突次数 | 一次解决完 | 可能每个提交都要解一次 |
| 适合 | 合进公共分支、多人协作 | 本地收拾自己的提交、同步上游 |
| 危险点 | 历史较乱 | 已推送的分支 rebase 后必须强推,会毁掉别人的基线 |
一条够用的规矩:自己本地的分支随便 rebase;只要别人可能基于它工作过,就只用 merge。 团队里"别乱 rebase"说的就是后半句。真要同步上游,用 git pull --rebase,只影响你本地尚未推送的提交。
⑤ 分支开多大、叫什么名
分支成本低,不代表可以乱开。判断标准只有一条:这条分支能不能用一句话说清"它做完之后 main 多了什么"。 说不清,就是开太大了。
| 做法 | 例子 | 评价 |
|---|---|---|
| 一个功能一条分支 | feature/tag-filter |
推荐。合并时冲突范围可控,回滚时能整条丢弃 |
| 一个修复一条分支 | fix/tag-active-class |
推荐。名字直接对应提交信息 |
| 一条分支干三件事 | feature/改标签顺便改配色再修个错字 |
不推荐。要么全合,要么全不合,没法只回滚一半 |
| 长期不合并的"开发分支" | dev 放了两个月 |
风险最高。合并那天等于一次大爆炸 |
命名用 类型/短描述,类型固定几个词就够:feature、fix、chore、docs。名字里的斜杠在 Git 里就是目录分隔,feature/tag-filter 对应 .git/refs/heads/feature/tag-filter,不影响使用。别用中文和空格——命令行补全、CI 脚本、URL 里都会出问题。
3.2.3 动手:造一次冲突,然后收掉它
确认在 dudao/,git status 是干净的。
第 1 步:开分支,改一处
git switch -c feature/tag-filter
形如:
Switched to a new branch 'feature/tag-filter'
打开 app.js,找到渲染标签栏的那个函数,把选中态类名改成 BEM 风格:
// feature 分支上的写法
btn.className = tag === state.activeTag ? 'tag tag--active' : 'tag';
提交:
git add app.js
git commit -m "feat: 标签选中态改用 BEM 类名"
第 2 步:回到 main,改同一行
git switch main
打开 app.js,同一个函数、同一行,改成另一种写法:
// main 上的写法
btn.className = state.activeTag === tag ? 'tag is-active' : 'tag';
git commit -am "fix: 标签选中态比较顺序"
-a 是"把所有已跟踪文件的改动先 add 再提交",只对已跟踪文件有效,新文件仍要手动 add。
第 3 步:合并,撞上冲突
git merge feature/tag-filter
真实输出(Git 2.5x):
Auto-merging app.js
CONFLICT (content): Merge conflict in app.js
Automatic merge failed; fix conflicts and then commit the result.
注意 Auto-merging 和 CONFLICT 同时出现:Git 已经尽力合了文件的其他部分,只在这一处停下。看状态:
git status
On branch main
You have unmerged paths.
(fix conflicts and run "git commit")
(use "git merge --abort" to abort the merge)
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: app.js
no changes added to commit (use "git add" and/or "git commit -a")
both modified 是冲突的正式说法:两边都改了同一个文件。此刻仓库处于"合并中"状态,git commit 会把这堆带标记的代码直接拍进去——这是新手最常犯的错。
第 4 步:读标记,做决定
打开 app.js,会看到:
<<<<<<< HEAD
btn.className = state.activeTag === tag ? 'tag is-active' : 'tag';
=======
btn.className = tag === state.activeTag ? 'tag tag--active' : 'tag';
>>>>>>> feature/tag-filter
两边其实做的是同一件事:把当前标签高亮。差别只在比较顺序和类名。决策是"保留 BEM 类名,同时采用 main 的比较顺序",于是手动改成一行:
btn.className = state.activeTag === tag ? 'tag tag--active' : 'tag';
删掉三行标记。存盘后确认标记真的没了:
grep -n "<<<<<<<\|=======\|>>>>>>>" app.js
没有输出才算干净。很多"页面莫名其妙多了几行乱码",就是这一步漏了 =======。
第 5 步:标记解决并收尾
git add app.js
git status -s
M app.js
左列 M 表示已标记为解决。收尾:
git commit -m "merge: 合并 feature/tag-filter"
形如:
[main 9f1c2ab] merge: 合并 feature/tag-filter
不带 -m 时 Git 会打开编辑器,里面预填了 Merge branch 'feature/tag-filter',保存退出即可。但对零基础读者这是个陷阱:默认编辑器可能是 vim,进去之后按什么都没反应,其实要先按 i 进入插入模式、改完按 Esc 再输入 :wq 回车。能一条命令说清的,就别让自己进编辑器。
看历史:
git log --oneline --graph
* 9f1c2ab (HEAD -> main) Merge branch 'feature/tag-filter'
|\
| * 4d7e8f1 (feature/tag-filter) feat: 标签选中态改用 BEM 类名
* | 2b9c3d4 fix: 标签选中态比较顺序
|/
* 7d3f9a2 feat: 标签栏增加选中态
分叉、汇合、两个父提交,全在图上。分支用完就删(提交不会丢):
git branch -d feature/tag-filter
第 6 步:如果不想合了
合并到一半发现方向错了,在 commit 之前可以整段撤销:
git merge --abort
工作区会回到合并前的样子。一旦提交了合并,就只能用 git revert -m 1 <合并提交> 反向撤销,麻烦得多。所以:合并中不确定时,先 abort,不丢人。
3.2.4 三个坑
坑 1:带着冲突标记提交了
症状:页面某处突然出现 <<<<<<< HEAD 这样的文字,或者 JS 直接 Uncaught SyntaxError: Unexpected token '<'。git log 里那条提交看着很正常。
成因:git commit -am 或 git add . 在冲突未解决时执行了。Git 只检查"有没有未合并路径",你一旦 add 过(哪怕内容还带标记),它就认为你解决了。
修法:先全局搜一遍标记,再改:
git grep -n "<<<<<<<"
改完 git add + git commit --amend(未推送)或新提交一条修复(已推送)。预防手段:合并后养成 git diff --check 的习惯,它能报出冲突标记和行尾空白。
坑 2:rebase 了公共分支,然后强推
症状:同事 git pull 之后,历史里出现两份一模一样的提交,或者推送被拒:
! [rejected] main -> main (non-fast-forward)
error: failed to push some refs to 'github.com:you/dudao.git'
成因:rebase 会重写提交哈希。你已经把旧版本推上去了,别人基于旧版本工作;你强推新版本,两套历史就打架。
修法:如果已经发生,别继续 push -f。让所有人暂停推送,由一个人把远端恢复到最后一次共识提交,再重新合。预防很简单:只 rebase 自己没推送过的提交;判断方法是 git log @{u}..HEAD --oneline——只列出本地领先远端的提交,这些才可以动。
坑 3:切分支时提示会覆盖本地改动
症状:
error: Your local changes to the following files would be overwritten by checkout:
app.js
Please commit your changes or stash them before you switch branches.
Aborting
成因:目标分支上这个文件的内容和你要带过去的未提交改动冲突。Git 拒绝执行,是为了不让你丢东西——这是保护,不是故障。
修法:三选一。① 改动属于当前分支:先 git commit;② 改动是临时的:git stash,切过去处理完再 git stash pop;③ 改动不要了:git restore app.js。不要用 git switch -f 硬切,那会直接丢掉未提交内容。
本章验收
- 能解释"建分支为什么不复制文件",并说出 ref 文件里存的是什么
- 能判断一次合并会走 fast-forward 还是三方合并,依据是什么
- 能逐行读懂
<<<<<<</=======/>>>>>>>三段标记,并说出各自归属 - 亲手解决过一次冲突,
git grep "<<<<<<<"无输出 - 能说出 merge 与 rebase 各自适合的场景,以及"别乱 rebase"具体指什么
- 知道合并卡住时
git merge --abort能整段退回
自测
Q1:git switch -c feature 之后,磁盘上多了什么?为什么它几乎是瞬时的?
看答案
只多了一个 `.git/refs/heads/feature` 文件,内容是一行当前提交的哈希;HEAD 改成指向它。没有复制任何工作区文件,所以不管项目多大都是瞬时。工作区文件一个都没变,因为新旧分支指向同一条提交,快照相同。Q2:冲突文件里 ======= 上下两段,哪段是"最新的"?
看答案
不能这么问。上段是当前分支(`HEAD`)的版本,下段是被合进来分支的版本,两者是并行关系,没有新旧之分,只有提交时间先后。判断该留哪个,要看意图和项目约定,而不是看谁更晚。很多事故就是把"我的版本"当成"最新版本"直接覆盖了对方的修复。Q3:为什么已经推送到远端的提交不能 rebase 之后再强推?
看答案
rebase 会重写提交对象,哈希全变,等于把原来的历史替换成一套新的。远端和同事的本地都还指着旧哈希,强推后他们的 `pull` 会看到两条无关的历史线,产生大量重复提交或冲突,严重时要手工修历史。只要提交已经离开你的电脑,就应视为公共历史,只用 merge 或 revert 增量修改。下一步
本地能开分支、能合、能解冲突了。但如果仓库只在你自己的硬盘上,一次误删、一次硬盘故障就全没了。下一章把它推到远端,并第一次走完 Pull Request 的流程。