git branch -a 显示本地和远程跟踪分支，但需先执行 git fetch --prune 同步并清理过期引用，否则可能漏掉新推送或已删除的远程分支；远程分支以 remotes/origin/xxx 形式显示，仅为本地缓存快照。
git branch -a 显示所有分支但容易漏掉远程跟踪分支
执行 git branch -a 确实能列出本地分支和远程分支（带 remotes/ 前缀），但前提是你的本地仓库已通过 git fetch 同步过远程分支信息。如果很久没拉取，remotes/origin/main 这类分支可能不会出现——不是 Git 没查到，而是本地的远程引用数据库过期了。
常见错误现象：git branch -a 不显示某个刚被同事 push 上去的分支，或者显示的远程分支比 GitHub/GitLab 上少。
- 必须先运行
git fetch --prune（或简写git fetch -p），强制同步并清理已删除的远程分支引用 -
git branch -r只看远程分支（不含本地），适合快速确认远端有哪些分支被记录在本地 -
git ls-remote --heads origin绕过本地缓存，直接查远程仓库真实 HEAD 列表（不依赖 fetch，但不显示本地分支）
git remote show origin 会显示分支对应关系但输出冗长
git remote show origin 不仅列出分支，还说明哪些本地分支已 track 远程分支、哪些已 ahead/behind，对排查推送失败或合并混乱特别有用。但它默认只显示当前配置的 remote（通常是 origin），且输出格式偏报告式，关键信息藏在段落里。
使用场景：你不确定 feature/login 是否已设置 upstream，或者 git push 报错 “failed to push some refs” 时需要确认远程是否存在同名分支。
- 加
-n参数可跳过自动 fetch，避免意外拉取（git remote show -n origin） - 输出中 “Local ref configured for 'git push'” 行告诉你哪些本地分支设置了默认推送目标
- “New remote branches” 表示有远程分支存在但尚未 fetch 到本地（这时仍需手动
git fetch origin <branch></branch>才能 checkout）
git ls-remote 和 git show-ref 的区别在于是否依赖本地对象库
git ls-remote origin 直接走网络协议查远程仓库的 ref 列表，不依赖本地 commit 或 fetch 记录；而 git show-ref 只读本地 .git/refs 目录，哪怕远程分支已被删，只要没 fetch -p，它仍会显示旧引用。
性能与兼容性影响：在超大仓库（如 Linux kernel）中，git ls-remote 响应快且结果准，但无法区分分支和 tag（除非加 --heads）；git show-ref --heads 速度快（纯本地 IO），但结果可能 stale。
- 查远程最新分支列表（权威）：
git ls-remote --heads origin - 查本地所有分支引用（含未 checkout 的）：
git show-ref --heads - 想过滤出特定命名分支？用
git ls-remote --heads origin | grep "release/"，比git branch -a | grep更可靠
远程分支名里的 origin/ 是别名不是路径
像 remotes/origin/main 这种显示，并不表示远程分支真的在 origin/main 路径下。它只是 Git 本地存储远程引用的约定位置：remotes/<remote-name>/<branch-name></branch-name></remote-name>。如果你执行 git remote add upstream https://...，那它的远程分支就会显示为 remotes/upstream/main。
容易踩的坑：有人看到 remotes/origin/main 就以为能直接 git checkout remotes/origin/main，其实这是只读的远程跟踪引用，不能直接切换。真要基于它工作，得用 git checkout -b main-from-upstream origin/main 或 git switch -c feat origin/feat。
- 远程跟踪分支（如
origin/main）本质是本地对远程分支的“快照”，每次fetch才更新 -
git branch -u origin/main是把当前本地分支关联到远程分支，不是创建新远程分支 - 删除远程分支要用
git push origin --delete <branch></branch>，而不是删本地的remotes/origin/<branch></branch>
git branch -a 当成实时视图，结果基于过期信息做决策。
