git分支是指向提交的指针，本质为.git/refs/heads/下的引用文件；git branch仅显示本地分支，不反映远程真实状态，需git fetch --prune同步。
Git 分支不是目录或文件，而是指向提交的指针；所有分支操作本质都是在读写 .git/refs/heads/ 下的引用文件。
git branch 命令只显示本地分支，不反映远程真实状态
运行 git branch 仅列出 .git/refs/heads/ 目录下的本地分支指针，它完全不访问远程仓库。即使远程已删除 feature/login，只要本地没执行 git fetch --prune 或 git remote update --prune，git branch -r 仍会显示 origin/feature/login —— 这是“幽灵分支”，实际已不存在。
常见错误现象：
- CI 推送后
git branch -r找不到新分支 - 删掉远程分支后，
git branch -r还能看见它
解决办法：
- 确认远程是否存在某分支：用
git ls-remote --heads origin feature/login，有输出即存在，无输出即已删除 - 同步远程分支列表到本地：先
git fetch --prune，再git branch -r - 避免依赖
git branch -r做自动化判断，它只是缓存快照
HEAD 是一个符号引用，不是分支本身
.git/HEAD 文件内容通常是 ref: refs/heads/main，表示它间接指向 main 分支所指的提交。只有在“分离 HEAD”状态下（比如 git checkout 7a98805），HEAD 才直接存 SHA 值。
为什么这重要？
-
git commit总是把新提交挂在当前HEAD所指的分支上；如果处于分离 HEAD 状态，提交不会属于任何分支，容易丢失 -
git status显示 “on branch main” 或 “HEAD detached at 7a98805”，本质就是读取.git/HEAD并解析其内容 - 脚本中判断是否在分支上，不能只看
git branch输出，而应检查cat .git/HEAD是否以ref:开头
远程分支引用（origin/main）是只读的本地跟踪指针
origin/main 不是远程仓库的实时镜像，而是你本地 .git/refs/remotes/origin/main 文件里存的一个 SHA 值，它只在 git fetch 或 git pull 时更新。Git 不允许你直接 git checkout origin/main 后提交——因为它是只读引用。
辅助阅读和快速理解 GitHub/Git 项目结构与核心价值的结构化方法论。 当用户请求"分析这个 GitHub 项目"、"帮我读一下这个 repo"、"了解这个项目是做什么的"、 "怎么用这个项目"、"怎么跑这个项目"、"这个项目用了哪些技术"，或任何涉及 GitHub/Git 仓库阅读、理解、技术评估、快速上...
典型误操作：
- 以为
git checkout origin/feature-x能切换并开发，实际进入分离 HEAD 状态 - 手动修改
.git/refs/remotes/origin/*文件试图“伪造”远程分支位置（Git 下次 fetch 会覆盖） - 用
git push origin :feature-x删除远程分支后，忘记git fetch --prune清理本地origin/feature-x
正确做法：
- 想基于远程分支新建本地分支：
git checkout -b feature-x origin/feature-x - 想更新所有远程跟踪引用：
git fetch --all --prune - 查看远程分支最新 SHA：
git ls-remote origin main（绕过本地缓存）
git show-ref 是最底层的引用查看命令
git show-ref 直接读取所有引用（包括 HEAD、分支、tag、rebase 中间状态），不加参数时输出形如：
7a98805f2d1c4e6a7b8c9d0e1f2a3b4c5d6e7f8a refs/heads/main 93b412c8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2 refs/heads/iss53 ref: refs/heads/main refs/HEAD
它比 git branch 更原始、更可靠，适合写脚本或排查引用异常：
- 查某个分支是否真的存在：
git show-ref refs/heads/feature-x - 查所有远程引用：
git show-ref --heads --remotes - 查所有 tag：
git show-ref --tags
注意：git show-ref 不做任何网络请求，也不触发 fetch，纯本地操作。
真正理解分支，得习惯把 main、origin/main、HEAD 当成三个独立的、可验证的文件路径来看待，而不是抽象概念。多数“分支不见”“切错分支”“推送失败”的问题，根源都在混淆了这些引用的读写权限和更新时机。
