个人站点
Git

主线 · 第 3 / 8 篇

· 约 7 分钟

分支到底是什么:分支、HEAD 和游离状态

分支只是一个指向提交的名字,新建分支只多写一个几十字节的文件。HEAD 平时指向当前分支,提交时跟着分支往前走;直接指向某个提交时就是游离状态,这时新建的提交没有名字保护。

本文目录 6 节
  1. 分支是一个指向提交的名字
  2. HEAD 指向当前分支
  3. 游离 HEAD:直接指向一个提交
  4. 带着没提交的改动切换分支
  5. 删掉分支,删掉的是名字
  6. 参考资料

关于分支,常见的疑问有几个。切换分支是不是把整个项目复制了一份?删掉一个分支,上面的提交是不是也跟着没了?Git 提示 HEAD detached,是不是出了什么错?这几个问题的答案都落在同一件事上:分支和 HEAD 都只是名字,不是装着文件的容器。

先说明几个词。引用(ref)是一个可以改指向的名字,内容只是一个提交的哈希,第一篇末尾提到过。分支是 refs/heads/ 下的引用。HEAD 是一个特殊的名字,表示“现在在哪里”。

分支是一个指向提交的名字

Pro Git 的定义很短:Git 的分支,本质上只是指向提交对象的可变指针。

接着用前两篇的演示仓库。它有 first 和 second 两次提交,main 指向 second。新建一个叫 feature 的分支,再看 .git 里多了什么:

$ git branch feature
$ git branch -v
  feature 86c0fab second
* main    86c0fab second

两个分支指向同一个提交 86c0fab。仓库里新增的只是 .git/refs/heads/feature 这一个文件,内容是 86c0fab 的完整哈希加一个换行,一共 41 个字节。没有复制任何文件,也没有新建任何对象。Pro Git 也用这个数字解释为什么 Git 建分支这么快:相当于往一个文件里写 41 个字节。

所以“切换分支等于复制项目”的印象并不准确。项目的每一份快照本来就以对象的形式存在仓库里,分支只是挑出其中一个提交,给它起个名字。

HEAD 指向当前分支

HEAD 也是 .git 里的一个文件。在 main 上时,它的内容是 ref: refs/heads/main;切换到 feature 以后,变成 ref: refs/heads/feature。Pro Git 把它解释为当前分支的别名。

HEAD 指向分支,分支指向提交,于是有了提交时分支往前走的规律。git-checkout 文档讲得很细:在分支上提交,Git 先新建一个提交,父提交是原来的那个,然后把分支改成指向新提交。HEAD 本身没变,仍然指向这个分支,只是间接指到了新提交。

在 feature 上加一个 feature.txt 并提交,feature 指向了新提交 104692f,main 仍是 86c0fab。切回 main,工作区里的 feature.txt 不见了,因为 main 指向的快照里没有它。切换分支做两件事:让 HEAD 指向另一个分支,再用那个分支的快照更新暂存区和工作区。

再在 main 上改一次 docs/a.txt 并提交,历史就分了叉:

$ git log --oneline --graph --all
* 67225f7 (HEAD -> main) update docs
| * 104692f (feature) add feature.txt
|/
* 86c0fab second
* b6c8214 first

HEAD -> main 表示 HEAD 指向 main。两条线共用 second 之前的历史,从这里开始各走各的。

容易误解的一点是“这个提交属于 feature 分支”。提交对象里只有树、父提交、作者、提交者和说明,没有分支名。说一个提交在某个分支上,意思是从这个分支指向的提交出发,顺着父提交能走到它,也说它从这个分支可达(reachable)。git branch --contains 列出的就是这样的分支,一个提交可以同时在好几个分支上。

游离 HEAD:直接指向一个提交

HEAD 平时指向分支,但也可以不经过分支,直接指向一个提交。git-checkout 文档把这叫作游离 HEAD(detached HEAD),并说明这只是表示 HEAD 指向一个具体的提交,而不是一个分支名。

用 git switch 切到一个提交,它会先拦一下,要求明确加 --detach:

$ git switch b6c8214
fatal: a branch is expected, got commit 'b6c8214'
$ git switch --detach b6c8214
HEAD is now at b6c8214 first

这时 .git/HEAD 里不再是 ref: ...,而是 b6c8214 的完整哈希,git status 第一行是 HEAD detached at b6c8214。旧一些的 git checkout <提交> 不要求加参数,直接进入同样的状态。

HEAD 是否经过分支 在 main 上时,HEAD 指向 main,main 指向 67225f7。切到 first 的游离状态后,HEAD 直接指向 b6c8214,main 仍指向 67225f7。这里只画引用关系,省略提交之间的父子关系。 在 main 上:经过分支 HEAD main 67225f7update docs HEAD 保存的是 ref: refs/heads/main 游离 HEAD:直接指向提交 HEAD b6c8214first main 67225f7update docs HEAD 保存提交的完整哈希main 的指向没变
圆角标签是名字,矩形框是提交;箭头只表示引用指向。游离的是 HEAD,不是 main 分支。

只是看看旧版本,游离状态没有任何风险。问题出在这时提交。在 first 上加一个文件,提交得到 1503661,它只被 HEAD 指着。一旦切回 main,就没有任何名字指向它了,Git 会提醒:

$ git switch main
Warning: you are leaving 1 commit behind, not connected to
any of your branches:

  1503661 experiment

完整提醒的后半段还给出了办法(上面没有截取):git branch <新分支名> 1503661,给它补一个名字。按 git-checkout 文档的说法,没有引用指向的提交,最终会被 Git 的例行垃圾回收删除,除非在那之前给它建一个引用,分支和标签都可以。如果还没离开,用 git switch -c <新分支名> 就地建分支,HEAD 也就不再游离。

所以 HEAD detached 不是错误,是一种状态。需要留意的只有一件事:在这个状态下做的提交,离开之前要给它一个名字。

带着没提交的改动切换分支

切换分支要更新工作区,工作区里还有没提交的改动时会怎样?git-switch 文档的说法是:切换分支不要求暂存区和工作区是干净的,但如果切换会导致本地改动丢失,操作就会中止。

演示仓库里有两种情况。第一种,README.md 在 main 和 feature 上内容相同,在 main 上改了它再切到 feature,切换成功,git status --short 仍是 M README.md。改动跟着过来了,因为它在工作区,不在任何分支上。

第二种,先让 main 上的 README.md 和 feature 上不一样,再改它,然后切换:

$ git switch feature
error: Your local changes to the following files would be overwritten by checkout:
	README.md
Please commit your changes or stash them before you switch branches.
Aborting

Git 拒绝切换,仍然留在 main,改动没有丢。Pro Git 的建议是切换之前保持干净的状态,也就是先提交,或者先把改动临时收起来。临时收起来用的是 stash,主线不展开。

删掉分支,删掉的是名字

git branch -d 删除分支前会检查。按 git-branch 文档,这个分支必须已经完全合并:设了上游(第五篇讲)就和上游比,演示仓库没设,就和 HEAD 比。feature 上的 104692f 还没有合并进 main,所以:

$ git branch -d feature
error: the branch 'feature' is not fully merged
$ git branch -D feature
Deleted branch feature (was 104692f).

-D 是 --delete --force 的简写,不做这项检查。删除后用 git cat-file -t 104692f 查,仍然是 commit。删掉的是 refs/heads/feature 这个名字,提交对象还在,只是和游离状态下留下的提交一样,没有名字指着了。它什么时候会被清理、清理之前怎么找回,留到讲 reflog 的那一篇。

oh-my-git 讲分支的那一组关卡,把分支画成时间线上的标签:可以新建、删除,也可以挪到别的提交上。挪动分支用的是 reset,那是讲撤回时的内容。

审 AI 的 Git 操作时,提交之前先看它在哪个分支上,git status 第一行或 git branch --show-current 都能看出来。看到 HEAD detached,要确认它做的提交有没有落到某个分支上。可以看 git log --oneline --decorate -1:显示 (HEAD -> main) 是在分支上,显示 (HEAD, main) 或只有 (HEAD) 是游离。它说“删了分支”时,留意输出里 was 后面的哈希,需要时凭这个哈希还能把分支建回来。

参考资料

  • Pro Git:分支简介:分支是指向提交的可变指针,HEAD 指向当前分支,新建分支相当于写 41 个字节。
  • Pro Git:分支的新建与合并:切换分支前保持干净的状态。
  • git-checkout:DETACHED HEAD 一节,提交时分支怎样更新,没有引用的提交最终会被垃圾回收。
  • git-switch:切换分支不要求干净,但会导致本地改动丢失时中止;--detach。
  • git-branch:-d 要求已完全合并,-D 是强制删除。
  • oh-my-git:讲分支的一组关卡,分支是时间线上的标签。

本文涉及的知识点

8 个

名称打开知识图谱中的对应条目;「另见」只计已发布文章。