git branch 显示的是本地 .git/refs/heads/ 下指针文件的快照，不查远程、不验证存在性；git branch -r 同理只读取 .git/refs/remotes/ 下缓存文件，故远程删除后仍显示“幽灵分支”，需 git fetch --prune 同步清理。
git branch 显示的不是“分支列表”，而是本地 .git/refs/heads/ 目录下指针文件的快照；它不查远程，不验证存在性，只读文件。这是绝大多数误判分支状态的根源。
git branch -r 为什么显示已删除的远程分支？
因为 git branch -r 只读取本地 .git/refs/remotes/ 下的缓存文件，比如 .git/refs/remotes/origin/feature/login。远程分支早被删了，但这个文件还躺在你磁盘上。
常见错误现象：
- CI 推送新分支后，
git branch -r找不到它 - 执行
git push origin --delete feature/login后，git branch -r仍显示origin/feature/login
正确做法：
- 确认远程是否存在：运行
git ls-remote --heads origin feature/login，有输出表示还在，空输出说明已被删 - 同步本地远程引用：先
git fetch --prune（或git remote update --prune），再git branch -r - 脚本中禁止依赖
git branch -r做分支存在性判断——它只是过期缓存
HEAD 文件内容决定你是否在分支上
.git/HEAD 是一个符号引用，内容通常是 ref: refs/heads/main；只有在分离 HEAD 状态（如 git checkout abc123）时，它才直接存 SHA 值。
为什么这关键？
Git Changelog Generator
下载
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
-
git commit总是把新提交挂在HEAD所指的分支上；如果cat .git/HEAD不以ref:开头，说明你不在任何分支上，提交会孤立 -
git status显示 “on branch main” 或 “HEAD detached at abc123”，本质就是解析.git/HEAD - 自动化脚本里判断是否在分支上，不能靠
git branch输出带*，而应检查cat .git/HEAD | grep '^ref:'
origin/main 不是实时镜像，只是本地 SHA 缓存
origin/main 是存于 .git/refs/remotes/origin/main 的一个纯文本文件，里面只有一行 SHA 值。它不会自动更新，只在 git fetch 或 git pull 时被重写。
这意味着：
- 你本地的
origin/main可能比远程落后几十个提交，但git branch -r依然显示它“存在” -
git merge origin/main实际合并的是你本地缓存的 SHA，不是远程当前最新提交 - 想确保用最新远程状态，必须先
git fetch，而不是直接git pull（后者隐含merge，可能跳过 fetch 步骤）
分支创建和切换全是文件操作，不是复制
执行 git branch feature/login，Git 只在 .git/refs/heads/ 下新建一个文件 feature/login，内容是当前 HEAD 指向的 SHA；git switch feature/login 则改写 .git/HEAD 文件，让它指向 refs/heads/feature/login。
所以：
- 新建分支开销几乎为零，没有文件复制，不占额外空间
- 切换分支时工作目录变更，是因为 Git 根据新分支指针所指的提交，重新检出（checkout）对应快照
- 如果你手动删掉
.git/refs/heads/feature/login，就等于彻底删掉该分支——Git 不会报错，也不会恢复
.git/HEAD、.git/refs/heads/*、.git/refs/remotes/*。它们不联网、不校验、不感知远程——除非你显式触发 fetch 或 ls-remote。
