git分支是存于.git/refs/heads/下的纯文本指针文件，内容仅为对应commit的40位sha-1哈希值，无元信息；head为符号引用，指向当前分支；远程分支存于.git/refs/remotes/，由fetch更新；packed-refs用于合并引用以减少i/o，读取时优先loose refs后fallback。

分支引用文件存放在 .git/refs/heads/ 目录下

Git 分支不是独立实体，而是纯文本指针文件，每个分支对应 .git/refs/heads/ 下的一个文件。比如你有 main 分支，那就会存在 .git/refs/heads/main；运行 git branch feature 后，.git/refs/heads/feature 就会被创建。

这些文件内容只有一行，就是该分支当前指向的 commit 的完整 SHA-1 哈希值（40 位十六进制字符串），例如：1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b。它不包含任何元信息——没有作者、时间、提交消息，也不记录历史链路，只是一个裸指针。

• 分支名本身不参与存储逻辑，只是文件名；删掉 .git/refs/heads/feature，就等于删除了 feature 分支（但不会删 commit 对象）
• 手动修改这个文件的内容（比如把哈希换成另一个 commit）等价于强制移动分支指针，git reset --hard <commit></commit> 底层就干这事
• 如果分支名含斜杠（如 feature/login），Git 会自动在 .git/refs/heads/ 下建子目录 feature/，再放 login 文件——路径结构即分支命名结构

HEAD 文件决定当前分支的符号引用关系

.git/HEAD 是一个符号引用（symbolic reference），内容通常是 ref: refs/heads/main 这类格式。它不直接存哈希，而是告诉 Git：“我现在正在 main 分支上”，然后 Git 再去读 .git/refs/heads/main 找具体 commit。

当你执行 git checkout dev 或 git switch dev，Git 实际只做了两件事：修改 .git/HEAD 的内容为 ref: refs/heads/dev，并重置工作区和暂存区到 dev 指向的 commit。它并不“切换代码”，只是更新指针 + 同步文件状态。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

• 如果 .git/HEAD 里是直接的 SHA-1（比如 1a2b3c...），说明处于分离头指针（detached HEAD）状态，此时新建 commit 会生成孤立节点，没人引用它，容易丢失
• git symbolic-ref HEAD 可安全读取当前符号引用目标，比直接 cat .git/HEAD 更可靠（避免误判 detached 状态）
• 不要手动编辑 .git/HEAD —— 用 git checkout 或 git switch，否则可能破坏 reflog 和后续操作一致性

远程分支引用保存在 .git/refs/remotes/ 目录

远程分支（如 origin/main）不是本地分支的副本，而是独立引用，存放在 .git/refs/remotes/origin/main。它的作用只有一个：记住上次 git fetch 时，远程 main 分支所在的位置。

这个引用**不会自动更新**。即使远程仓库的 main 已推进，你的 origin/main 仍停在旧 commit，直到你再次 git fetch。这也是为什么 git pull 要先 fetch 再 merge/rebase——merge 的对象是本地 origin/main，不是实时远程状态。

• git remote update 或 git fetch --all 才会批量更新所有 refs/remotes/* 文件
• 删掉 .git/refs/remotes/origin/feature 不影响远程仓库，只清空本地对该远程分支的缓存记录
• git ls-remote origin 查的是远程真实引用，而 git show-ref remotes/origin/main 查的是你本地缓存的值，二者可能不同

packed-refs 文件会影响引用读取顺序

当引用数量变多（尤其大量标签或 CI 自动生成分支时），Git 会把部分引用打包进 .git/packed-refs 文件，以减少磁盘小文件开销。这个文件是纯文本，每行形如：1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b refs/heads/main。

Git 读取引用时，**优先检查 .git/refs/ 下的单个文件，再 fallback 到 packed-refs**。这意味着：如果你同时在 .git/refs/heads/main 和 packed-refs 里定义了 main，前者生效；但一旦你删掉前者，Git 就会回退到后者。

• git pack-refs --all 手动触发打包，常用于仓库瘦身或归档前清理
• packed-refs 不包含未打包的引用（比如刚创建的分支），所以不能单独依赖它做引用发现
• 某些老旧脚本直接遍历 .git/refs/heads/ 目录判断分支存在，会漏掉只存在于 packed-refs 中的分支——应改用 git for-each-ref refs/heads/

实际调试时，别只盯着 git branch 输出；想确认某个分支到底指向哪，最稳的方式是：git rev-parse main（读 refs/heads/main），而不是靠 cat .git/refs/heads/main —— 因为它可能已被打包或被钩子临时覆盖。引用系统看似简单，但指针层级、缓存机制、符号引用与直接引用的混用，是很多“分支不见了”“push 不生效”问题的根源。