分支、合并与冲突
上一课的撤销都发生在一条线上。现在我们需要两条线同时存在:报表写到一半,结算阈值临时要改, 这两批改动不能挤进同一条提交线。也就是说当我们需要独立于现在的情况下新开发一个版本,同时之前的分支也需要保留的时候。
命令 | 作用 |
|---|---|
git switch -c 名字 | 从当前提交新建分支并切过去 |
git branch 名字 | 只新建,不切换 |
git switch -c 名字 提交 | 从指定提交新建 |
起点是默认main分支、两条提交:
git log --oneline --graph --decorate --all
* 346118e (HEAD -> main) add free-shipping threshold
* 5d0dc49 init project skeleton新建分支
git switch -c feature/report
Switched to a new branch 'feature/report' git rev-parse main feature/report #rev-parse将对象看做哈希值
346118e0f2ac217933620523acaa7942479af76d #main的哈希值
346118e0f2ac217933620523acaa7942479af76d #feature/report的哈希值 ls
app.js
checkout.js #工作区文件也没有改变两条分支打出来的哈希一模一样,工作区还是那两个文件 —— 没有文件被复制,历史现在还没有开始分支(但是这里已经创建了)。
在这条新线上提交一次,两边才分开:
1,创建一个report.js文件
git add report.js
git commit -m "add monthly report"
[feature/report 500955a] add monthly report 1 file changed, 1 insertion(+) create mode 100644 report.js ls
app.js
checkout.js
report.jsreport.js 只属于 feature/report 这条线,main 上没有它。 刚才那次提交到底改了什么?直接去看存分支引用的文件:
cat .git/refs/heads/feature/report
500955aec83a8756febb54423a2d3f0a7dd460c5.git/refs/heads/ 是存放本地分支引用的目录,一个文件对应一条分支。 因为分支名里带斜杠,feature/report 实际落在子目录里: .git/refs/heads/feature/report。文件里只有一行——这次提交的四十位哈希。
再看两个文件的大小:
wc -c .git/refs/heads/main .git/refs/heads/feature/report
41 .git/refs/heads/main
41 .git/refs/heads/feature/report
82 total两个文件都是 41 字节:40 位哈希 + 1 个换行符。 换句话说,一条分支在磁盘上就是这么一个 41 字节的小文本文件,没有别的东西。
把两个文件的内容并排看,提交做了什么就一目了然:
cat .git/refs/heads/main
346118e0f2ac217933620523acaa7942479af76d cat .git/refs/heads/feature/report
500955aec83a8756febb54423a2d3f0a7dd460c5main 还停在分叉前的 346118e,feature/report 已经是新提交 500955a。 刚才那次提交没有复制任何东西,它只是把 feature/report 这个文件里的哈希改写成了新提交的哈希。 每在当前分支上提交一次,Git 就改写这个文件一次——这就是“分支指针前移”的字面含义。
这类文件在 Git 里统一叫引用(reference,简称 ref)。 git branch 列出的每一项,背后都是 .git/refs/heads/ 下的一个文件: 文件名是分支名,文件内容是它指向的提交哈希。分支之所以“轻”,原因就在这里。
我怎么知道自己在哪条线上
git branch -v
* feature/report 500955a add monthly report main 346118e add free-shipping threshold git log --oneline --graph --decorate --all
* 500955a (HEAD -> feature/report) add monthly report
* 346118e (main) add free-shipping threshold
* 5d0dc49 init project skeletongit branch -v 列出所有分支,三列:分支名、它指向的短哈希、那次提交的信息。* 在谁左边,现在就是哪个分支。括号里写着两条链:HEAD 指向 feature/report,feature/report 指向 500955a;main 自己指着 346118e。切回 main,看到的是另一套文件:
git switch main
Switched to branch 'main' git log --oneline -1
346118e add free-shipping threshold ls
app.js
checkout.jsreport.js 不在了。它只存在于 500955a 那次提交里,而 main 停在分叉前的 346118e。切换分支时,Git 把工作区换成了 main 指向的那套文件,所以 report.js 消失了。
要理解这件事,得把两套“链”分开看:一套是引用链,一套是父链。
引用链回答「现在在哪、每条线头在哪」:
切换前:HEAD ─► feature/report ─► 500955a
切换后:HEAD ─► main ─► 346118e 另一条分支始终在原地:feature/report ─► 500955a注意 HEAD 的位置变了:切换前它指向 feature/report,切换后指向 main。 两条分支文件本身(refs/heads/main 和 refs/heads/feature/report)一个字节都没动, 变的只是 .git/HEAD 里写的那行分支名。
父链回答「历史从哪来」,它藏在每个提交对象的 parent 字段里:
500955a ─► 346118e ─► 5d0dc49 ▲ main 和 feature/report 分叉的地方500955a 的父提交是 346118e,346118e 的父提交是 5d0dc49。 这条链由提交对象自己串起来,和分支指针无关。切分支时父链一动不动——它本来就是不可变的历史。
所以「切换」只做两件事,且只碰引用链和工作区:
动作 | 改了什么 | 没改什么 |
|---|---|---|
挪 |
| 分支文件、提交对象 |
换工作区 | 磁盘上的文件,变成目标提交记录的那套 | 暂存区会被同步重置,历史不变 |
一句话对比:引用链是“名字 → 哈希”,可以改;父链是“提交 → 父提交”,不可改。 切换只动前者,外加工作区文件。
切分支时手上还改着文件,会怎样
这要分两种情况:改的是已跟踪文件,还是未跟踪文件。Git 对两者的处理不一样。
情况一:已跟踪文件有未提交改动
在 main 上修改已跟踪的 app.js,不提交,直接切走:
git status -s M app.js git switch feature/report
M app.js
Switched to branch 'feature/report' git status -s M app.js切换前后 git status -s 都是同一个 M,改动还在。 中间那行 M app.js 是 Git 的回执:它把未提交的改动一起带到了新分支。也就是说修改追踪的文件然后切换分支,修改内容会保留
为什么能带过去?因为 app.js 在 main 和 feature/report 上指向的内容相同, 切换时不需要重写这个文件,改动自然原样保留。这份改动不属于任何分支,它只存在于工作区; 你在哪条分支上 git commit,它就落进哪条分支的历史。
改动跟的是工作区,不是分支
说“改动跟的是人”容易误会成改动会自动绑定某条分支。更准确:未提交的改动只存在于工作区和暂存区, 切换分支时 Git 尽量保留它们;一旦提交,才归属当前分支。
情况二:未跟踪文件与目标分支上的文件同名
先把手上的改动退掉,回到干净状态,再制造一个未跟踪文件:
git restore app.js
git switch main
Switched to branch 'main' echo "export const report = 'draft'" > report.js #创建新的未跟踪文件report.js
git status -s
?? report.jsreport.js 是新文件,从未被 Git 跟踪,所以显示 ??。 而目标分支 feature/report 上恰好有一个同名的、已跟踪的 report.js。现在切换:
git switch feature/report
error: The following untracked working tree files would be overwritten by checkout: report.js
Please move or remove them before you switch branches.
AbortingGit 直接拒绝。原因:切换分支需要把工作区更新成目标提交的内容,这一步会覆盖同名的未跟踪文件。 未跟踪文件没进过版本库,一旦被覆盖就彻底丢失,Git 不能替你决定“这个草稿可以扔”,所以宁可中止。
提示里的 checkout 是底层命令名。历史上切换分支用的是 git checkout,后来 Git 把它拆成了职责更单一的 git switch(切分支)和 git restore(恢复文件),但底层报错信息仍沿用旧名字。
处置两条路:
草稿还要:先把它提交到当前分支,或改名备份,再切换;
草稿不要了:
rm report.js删掉再切。
rm report.js
git switch feature/report
Switched to branch 'feature/report' git switch main
Switched to branch 'main' git status -s
(无输出,工作区干净)机制一句话
切换分支时,Git 只重写与目标提交不一致的文件。
已跟踪文件的未提交改动,如果不会和目标内容冲突,就原样带到新分支;
如果会冲突(比如目标分支上该文件内容不同),Git 也会拒绝,让你先处理;
未跟踪文件一旦会被覆盖,Git 一律拒绝,因为它无法保证你的数据不丢。
核心原则只有一条:切换分支不能悄悄丢掉你手上的数据。 能安全带走就带走,带不走就停下来问你。
如果想合拼分支(快进)
就用git merge
git merge 的方向容易弄反:git merge 分支名 的参数是交出方,当前分支是接收方。 要把 feature/report 合进 main,先站到 main 上,再敲交出方的名字:
git merge feature/report
Updating 346118e..500955a
Fast-forward report.js | 1 + 1 file changed, 1 insertion(+) create mode 100644 report.js快进(fast-forward)成立的条件是:接收方从分叉点起一个提交都没有。 既然 main 只是停在分叉点、没往前走,就没有“两条线要接”的问题;Git 不需要造新提交, 只要把 main 这根指针挪到 500955a。
屏幕上两行正好对应这件事:
输出行 | 含义 |
|---|---|
|
|
| 这次只挪指针,没有新建提交 |
合完再打一遍刚才那两条命令:
git log --oneline --graph --decorate --all
* 500955a (HEAD -> main, feature/report) add monthly report
* 346118e add free-shipping threshold
* 5d0dc49 init project skeleton git branch -v feature/report 500955a add monthly report
* main 500955a add monthly report和「我怎么知道自己在哪条线上」那两份对着看:括号里原来是 (HEAD -> feature/report) 和 (main), 现在并成 (HEAD -> main, feature/report),346118e 那行的括号消失了; branch -v 两行的哈希从 500955a 与 346118e 变成都是 500955a。 提交条数没变,还是三条 —— 快进不产生新提交,只是让两条分支指向同一个点。
两条线都往前走过了,怎么合
两边各自往前走一步,快进就不成立了。先造出这种局面:
git switch -c feature/fee
Switched to a new branch 'feature/fee' echo "export const fee = 5" > fee.js
git add fee.js
git commit -m "add platform fee" #切换到'feature/fee'分支并提交
[feature/fee 03cb4ca] add platform fee 1 file changed, 1 insertion(+) create mode 100644 fee.js git switch main
Switched to branch 'main' echo "export const freeShipping = 199" > checkout.js
git commit -am "raise free-shipping threshold to 199" #切换到'main'分支并提交
[main 77a9ea0] raise free-shipping threshold to 199 1 file changed, 1 insertion(+), 1 deletion(-)-a 把已跟踪文件的改动直接放进暂存区,省掉一次 git add。 两边各往前走一步,图就分叉了:
git log --oneline --graph --decorate --all #--graph是可视化分支图
* 03cb4ca (feature/fee) add platform fee
| * 77a9ea0 (HEAD -> main) raise free-shipping threshold to 199
|/ * 500955a (feature/report) add monthly report
* 346118e add free-shipping threshold
* 5d0dc49 init project skeleton| 是分出去的那条线,|/ 是它并回共同祖先的位置 —— 两条线在这里之前是同一段历史。 这时快进不成立:main 上已经有 feature/fee 没有的提交 77a9ea0, 如果只是把指针挪到 03cb4ca,77a9ea0 就会从主线脱离。所以 Git 拒绝快进:
git merge --ff-only feature/fee
fatal: Not possible to fast-forward, aborting.--ff-only 的意思是「只许快进,快不了就失败」。 分支各有提交,所以报错:只挪指针会让一边的提交掉出历史。 去掉 --ff-only,让 Git 造一个合并提交:
git merge feature/fee
Merge made by the 'ort' strategy. fee.js | 1 + 1 file changed, 1 insertion(+) create mode 100644 fee.js这一次造出了合并提交(merge commit):一种专门用来把两条线接起来的提交。 它和普通提交的区别只有一个:它有两个父提交,一边一个。 白话说是“两条线在这里汇合”;术语叫三方合并 —— 拿共同祖先 500955a 和两边的最新提交,三份内容算出一个新状态。 ort 就是干这件事的算法名。
屏幕上看得见的是图里那一行 —— * 后面多一个空格,下面立刻分成两行:
git log --oneline --graph --parents -4
* 95f2865 77a9ea0 03cb4ca Merge branch 'feature/fee'
|\ | * 03cb4ca 500955a add platform fee
* | 77a9ea0 500955a raise free-shipping threshold to 199
|/ * 500955a 346118e add monthly report git rev-list --parents -1 HEAD
95f2865b0d07ee9cd8cdd6539df4e33a262b57ca 77a9ea0122cc5f0c5eba72c7d7f49a59fdda5ea2 03cb4ca0f31999241a6c98c0d0b3bdf7ea62b485rev-list --parents -1 HEAD 输出一行三个哈希:自己是 95f2865,父一是 77a9ea0,父二是 03cb4ca。 普通提交只有一个父;合并提交有两个父,所以历史能在这里“分叉再汇合”。
两边改了同一行,谁来定
git switch -c hotfix/shipping
Switched to a new branch 'hotfix/shipping' echo "export const freeShipping = 79" > checkout.js
git commit -am "lower threshold to 79"
[hotfix/shipping f48aa4d] lower threshold to 79 1 file changed, 1 insertion(+), 1 deletion(-) git switch main
Switched to branch 'main' echo "export const freeShipping = 299" > checkout.js
git commit -am "raise threshold to 299"
[main 5166675] raise threshold to 299 1 file changed, 1 insertion(+), 1 deletion(-)这次两边改的是同一个文件里的同一行,合并合不动:
git merge hotfix/shipping
Auto-merging checkout.js
CONFLICT (content): Merge conflict in checkout.js
Automatic merge failed; fix conflicts and then commit the result.冲突不是错误,是 Git 在说一句实话:同一行两边都动了,它判断不出该留哪个,于是不猜, 把两份都摆进文件交给人决定。术语叫内容级冲突(content conflict),屏幕上就是 CONFLICT (content) 这一行。仓库随即进入合并态:
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: checkout.js no changes added to commit (use "git add" and/or "git commit -a") git status -s
UU checkout.jsboth modified 是「两边都改了它」;短格式的两个 U 说的是同一件事, U 来自 unmerged。文件本身变成了三段:
{"cat checkout.js\n" + "<<<<<<< HEAD\n" + "export const freeShipping = 299\n" + "=======\n" + "export const freeShipping = 79\n" + ">>>>>>> hotfix/shipping"}
这就是冲突标记(conflict marker):三段横线把两份内容摆进同一个文件。 <<<<<<< HEAD 到 ======= 之间是当前分支 main 那一版, ======= 到 >>>>>>> hotfix/shipping 之间是被合并分支那一版。 标记只是 Git 插进去的提示,不是内容本身,解决完要删掉。
标记没删就提交,Git 不接:
git commit -m "merge hotfix/shipping"
error: Committing is not possible because you have unmerged files.
hint: Fix them up in the work tree, and then use 'git add/rm <file>'
hint: as appropriate to mark resolution and make a commit.
fatal: Exiting because of an unresolved conflict.
U checkout.js处置是两步,顺序不能换:先把文件改成最终内容,再 git add 告诉 Git 这个文件的冲突处理完了。 直接提交,它会一直拿这三个 U 挡回来。
两边给的是 299 和 79,最终留 199:冲突的解法不是二选一,自己写一个最终值就行。
echo "export const freeShipping = 199" > checkout.js
cat checkout.js
export const freeShipping = 199 git add checkout.js
git status -s
M checkout.js对照上面那份 git status -s:UU 变成了 M ,M 挪到了左列 —— 暂存区里已经是处理完的版本。现在可以提交:
git commit -m "Merge branch 'hotfix/shipping'"
[main 4360539] Merge branch 'hotfix/shipping' git log --oneline --graph --parents -4
* 4360539 5166675 f48aa4d Merge branch 'hotfix/shipping'
|\ | * f48aa4d 95f2865 lower threshold to 79
* | 5166675 95f2865 raise threshold to 299
|/ * 95f2865 77a9ea0 03cb4ca Merge branch 'feature/fee'
|\ 提交之后仍然是一个普通的两父合并提交。解冲突改的是文件内容,不改历史的形状。
合到一半发现方向不对
git switch -c hotfix/fee
Switched to a new branch 'hotfix/fee' echo "export const fee = 8" > fee.js
git commit -am "raise fee to 8"
[hotfix/fee 4da1802] raise fee to 8 1 file changed, 1 insertion(+), 1 deletion(-) git switch main
Switched to branch 'main' echo "export const fee = 3" > fee.js
git commit -am "lower fee to 3"
[main bffb89c] lower fee to 3 1 file changed, 1 insertion(+), 1 deletion(-) git merge hotfix/fee
Auto-merging fee.js
CONFLICT (content): Merge conflict in fee.js
Automatic merge failed; fix conflicts and then commit the result.同型冲突又出现一次。这次不打算合,整场退掉:
{"cat fee.js\n" + "<<<<<<< HEAD\n" + "export const fee = 3\n" + "=======\n" + "export const fee = 8\n" + ">>>>>>> hotfix/fee\n" + "\n" + "git status -s\n" + "UU fee.js\n" + "\n" + "git merge --abort\n" + "\n" + "git status -s\n" + "\n" + "git log --oneline -1\n" + "bffb89c lower fee to 3\n" + "\n" + "cat fee.js\n" + "export const fee = 3"}
git merge --abort 是整场撤销:回到敲 git merge 之前那一刻。 它自己不打印任何东西,证据在后面四行 —— git status -s 一行都没有了,git log -1 还是 bffb89c,cat 出来回到 3。 代价说明白:手动改到一半的内容一起丢,它没有第二份。
分支删不掉,Git 在拦什么
删之前先问一遍:哪些分支还没进主线。
git branch --no-merged main hotfix/fee git branch -d hotfix/fee
error: the branch 'hotfix/fee' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D hotfix/fee'
hint: Disable this message with "git config set advice.forceDeleteBranch false"报错的意思是「这条分支还没合进来」:它顶上的提交,除了它自己没有别的分支能走到;删掉引用,那段历史就没人指着了。 术语叫 not fully merged。处置两条:内容还要,就先合进去;确定不要,才用大写。
换一条已经合进来的分支,同一条命令直接放行:
git branch -d feature/report
Deleted branch feature/report (was 500955a). git branch -v feature/fee 03cb4ca add platform fee hotfix/fee 4da1802 raise fee to 8 hotfix/shipping f48aa4d lower threshold to 79
* main bffb89c lower fee to 3同一个 -d,两种结局:feature/report 的 500955a 已经在 main 的历史里(快进那一步合进来的),放行;hotfix/fee 的 4da1802 不在,就拦。 大写版跳过这道检查,不弹确认框:
git branch -D hotfix/fee
Deleted branch hotfix/fee (was 4da1802). git branch -v feature/fee 03cb4ca add platform fee hotfix/shipping f48aa4d lower threshold to 79
* main bffb89c lower fee to 3 git cat-file -t 4da1802
commit它敢跳过的原因是删的东西很小:删掉的还是那个 41 字节的引用文件,提交对象照旧躺在对象库里 —— 拿哈希问类型,答 commit,只是没有分支指着它了。git reflog 里那次提交也还记着:
git reflog -6
bffb89c HEAD@{0}: reset: moving to HEAD
bffb89c HEAD@{1}: commit: lower fee to 3
4360539 HEAD@{2}: checkout: moving from hotfix/fee to main
4da1802 HEAD@{3}: commit: raise fee to 8
4360539 HEAD@{4}: checkout: moving from main to hotfix/fee
4360539 HEAD@{5}: commit (merge): Merge branch 'hotfix/shipping'4da1802 HEAD@{3}: commit: raise fee to 8 就是被删掉的那次提交。最上面那行 reset: moving to HEAD 是上一节 git merge --abort 留下的:它把 HEAD 搬回合并前的位置,再清掉合并态。
不建分支,只想看一眼旧版本
git switch --detach HEAD~1
HEAD is now at 4360539 Merge branch 'hotfix/shipping' git status
HEAD detached at 4360539
nothing to commit, working tree clean git branch -v
* (HEAD detached at 4360539) 4360539 Merge branch 'hotfix/shipping' feature/fee 03cb4ca add platform fee hotfix/shipping f48aa4d lower threshold to 79 main bffb89c lower fee to 3分离头指针(detached HEAD)说的是:HEAD 没挂在任何分支上, 直接指着某一次提交。平时 HEAD 存的是分支名(ref: refs/heads/main), 再由分支文件指向提交;分离之后 HEAD 里直接是哈希,跳过了“分支”这一层。 所以下一次提交不移动任何分支名。
git branch -v 第一列本该是分支名,这里换成了 (HEAD detached at 4360539), 意思是没有分支认领这个位置。在这个状态下提交,回执抬头就写着 detached:
echo "export const tmp = 1" > tmp.js
git add tmp.js
git commit -m "wip on detached head"
[detached HEAD 454aa22] wip on detached head 1 file changed, 1 insertion(+) create mode 100644 tmp.js切走的一瞬间,Git 会把后果说清楚:
git switch main
Warning: you are leaving 1 commit behind, not connected to
any of your branches: 454aa22 wip on detached head If you want to keep it by creating a new branch, this may be a good time
to do so with: git branch <new-branch-name> 454aa22 Switched to branch 'main'主线上看不到它,reflog 里还在:
git log --oneline -3
bffb89c lower fee to 3
4360539 Merge branch 'hotfix/shipping'
5166675 raise threshold to 299 git reflog -3
bffb89c HEAD@{0}: checkout: moving from 454aa2252c5f60594ac17ec92b5819e4d0e0d8b0 to main
454aa22 HEAD@{1}: commit: wip on detached head
4360539 HEAD@{2}: checkout: moving from main to HEAD~1git log 的三条里没有 454aa22,git reflog 第二行就是它。 要用的话,警告里已经给了办法:git branch <名字> 454aa22 把它挂回一条分支。
在分离头指针上提交,切走之前先给提交建条分支
--detach 适合读老版本的文件、试编译,不适合在上面干活。那些提交不属于任何分支, 切走之后就只剩哈希,靠 git reflog 翻回来。
这一课把一条线拆成多条:分支是指向提交的引用,切换换的是 HEAD 和工作区;合并有两种结果, 快进只挪指针,合并提交多一个父;冲突把决定权交回给人;分支删不掉时,是 Git 在提醒那段历史还没合回去。
到这里全部操作都在同一个仓库里。两个仓库之间怎么对齐同一批提交,是下一课的事。