git for-each-ref 是最稳的批量提取本地分支名和提交哈希的方式，它原生支持格式化输出、自动处理 packed-refs 和 symbolic refs，且输出严格按格式串生成，适合脚本解析，而 git branch --format 属 porcelain 命令，受用户配置干扰、不保证字段对齐。
git for-each-ref 提取所有分支的提交哈希和名称
直接读取 .git/refs/heads/ 下文件会漏掉已删除但未清理的引用，也绕过 Git 的引用解析逻辑，结果不可靠。用 git for-each-ref 是最稳的批量提取方式，它原生支持格式化输出，且能自动处理 packed-refs 和 symbolic refs。
常见错误是写成 git branch --format——这属于 Porcelain 命令，输出受用户配置（如 branch.*.description）干扰，且不保证字段对齐；而 for-each-ref 输出严格按格式串生成，适合脚本解析。
- 提取本地分支名和最新提交哈希：
git for-each-ref --format="%(refname:short) %(objectname:short)" refs/heads/ - 加时间戳（作者日期）：
git for-each-ref --format="%(refname:short) %(objectname:short) %(authordate:iso8601)" refs/heads/ - 排除已被重命名但未删的旧分支（如
feature/foo被重命名为feat/foo）：加--sort=-committerdate并结合awk去重，但注意refname:short不含前缀，需用%(refname)全路径比对
git ls-remote 获取远程分支的 HEAD 提交（不需克隆）
想查远程仓库有哪些分支、各自指向哪个提交，又不想 git clone 或 git fetch？git ls-remote 是唯一能绕过本地引用直接读远程 ref 的 Plumbing 命令。它本质是调用 git-upload-pack 协议，返回 raw ref 列表。
容易踩的坑：默认只返回 refs/heads/* 和 HEAD，不包括 refs/tags/* 或 refs/pull/*（GitHub/GitLab 的 PR 分支），必须显式指定前缀；另外，输出是 tab 分隔，第一列是 object SHA，第二列是 ref 名，顺序固定，不能依赖空格切分。
- 列出 origin 远程所有 heads：
git ls-remote --heads origin - 只查特定前缀（如 release/*）：
git ls-remote --heads origin 'refs/heads/release/*'（单引号防 shell 展开） - 输出不含本地分支别名，也不做任何本地映射——拿到的 SHA 是远程当前值，可能和本地
origin/xxx不一致，尤其在未fetch时
用 git show-ref 验证分支是否存在且非空
git show-ref 比 for-each-ref 更轻量，适合快速探活：它只输出 ref 名与对应对象，不支持复杂格式化，但启动快、无额外开销。常用于 CI 中判断某分支是否已推送、或某 feature 分支是否真实存在（而非只剩 symbolic ref）。
典型误用是拿它当 git rev-parse 替代——show-ref 不解析 HEAD、master~2 这类表达式，只认完整 refname；而且如果 ref 指向一个 dangling commit（即该 commit 不在任何可达路径上），它仍会输出，需额外用 git cat-file -e 校验对象存在性。
- 检查分支是否存在：
git show-ref -q refs/heads/main（成功返回 0，不存在返回 1） - 批量验证多个分支：
git show-ref -q refs/heads/dev refs/heads/staging refs/heads/prod - 配合
--verify可拒绝 symbolic refs（比如HEAD指向refs/heads/old-branch但old-branch已删），此时会报错并返回非零码
避免 git rev-list 误判“活跃分支”
有人用 git rev-list -n1 branch-name 提取最新提交，再结合时间排序判断“最近活跃分支”。问题在于：rev-list 默认不考虑 reflog，只走 commit 图遍历，一旦分支被 force-push 覆盖，旧提交虽仍在对象库但已不可达，rev-list 就返回空——但这不代表分支不存在，只是当前 ref 指向了一个孤立提交。
真正要判断“分支是否还有活跃开发痕迹”，得结合 reflog：git reflog --date=iso entries refs/heads/xxx 才反映真实操作历史；而 rev-list 更适合做拓扑分析（如找共同祖先），不是状态查询工具。
- 安全获取分支 tip 提交：
git rev-parse refs/heads/main（快、准、不依赖可达性） - 查分支最近一次更新时间（reflog 级别）：
git reflog -n1 --format="%cd" refs/heads/main 2>/dev/null - 用
rev-list做 diff 统计（如git rev-list --count main..develop）没问题，但别把它当分支存在性断言
分支信息看似简单，但 plumbing 命令的语义边界很窄：每个命令只解决一个具体问题，混用就会出偏差。比如 ls-remote 不知道本地有没有对应 remote-tracking branch，for-each-ref 不告诉你这个分支 merge-base 是什么——得自己组合调用，而不是指望某个命令“全自动搞定”。
