git ls-remote --heads origin 是最轻量、最可靠的方式，直连远程仓库读取 refs/heads/ 下原始引用，不依赖本地 fetch 缓存，结果最真实；而 git branch -r 仅显示本地缓存的远程跟踪分支快照，需先执行 git fetch 才能更新；git remote show origin 则提供远程仓库完整状态，包括跟踪关系、分支清理提示等。
git ls-remote 查看远程分支原始引用
直接查远程仓库的分支列表，git ls-remote 是最轻量、最可靠的方式——它不依赖本地 fetch 记录，而是直连远程仓库读取 refs/heads/ 下的引用。适合在新克隆环境、或怀疑本地远程跟踪分支已过期时使用。
- 执行
git ls-remote --heads origin，输出形如a1b2c3d refs/heads/main和e4f5g6h refs/heads/feature/login，每行对应一个远程分支 - 加
-q可静默错误（比如远程不可达时不报错），但会掩盖网络问题，日常维护建议先不加 - 注意：该命令不解析别名，也不受
remote.origin.fetch配置影响，结果最“真实”，但也最原始——没有本地映射关系
git branch -r 显示已知的远程跟踪分支
git branch -r 看到的是你本地 Git 缓存的远程分支快照，本质是 refs/remotes/origin/xxx 引用。它快、易读，但前提是本地已执行过 git fetch 或 git pull。
- 如果刚克隆完仓库，运行
git branch -r只显示origin/HEAD和origin/main（或origin/master），其他分支不会出现——因为还没 fetch 过 - 想更新这个列表，必须先
git fetch origin；若只 fetch 某一分支，如git fetch origin feature/new-api，则git branch -r仍不会列出其他分支 - 输出中带星号的
origin/HEAD -> origin/main表示默认分支，不是实际分支，不能 checkout
git remote show origin 查看远程仓库完整状态
这个命令不只是列分支，还会告诉你哪些远程分支有对应的本地跟踪分支、哪些已合并、哪些被远程删除——对团队协作中的分支清理特别有用。
- 运行
git remote show origin后，会看到 “New remote branches”、“Stale tracking branches”、“Tracked remote branches” 等区块，信息密度高 - 其中 “Stale tracking branches” 列出那些远程已删、但本地还留着
remotes/origin/xxx引用的分支，这时应手动执行git remote prune origin清理 - 注意：该命令会尝试连接远程仓库（比如走 SSH 或 HTTPS），若网络慢或权限不足，会卡住几秒甚至超时，生产脚本中慎用
为什么 git branch -a 不推荐用于“查远程分支”
git branch -a 把本地分支和远程跟踪分支混在一起输出，看似全面，实则干扰判断。尤其当团队分支多、命名风格不统一时，容易漏看或误判。
- 输出里
remotes/origin/xxx才是远程分支的本地缓存，而xxx（无前缀）是本地分支——两者生命周期、推送权限、删除方式完全不同 - 例如
git branch -a | grep feature可能同时匹配到本地未 push 的feature/new-ui和远程已存在的remotes/origin/feature/new-ui，但它们状态可能完全不一致 - 真正需要确认“远程是否存在某分支”时，应优先用
git ls-remote --heads origin | grep feature/，避免本地缓存误导
远程分支列表不是静态快照，而是随 fetch、push、远程仓库操作实时变化的。日常维护中最容易忽略的，是把 git branch -r 的结果当成权威——它只是你上次 fetch 时的副本，不是此刻远程的真实状态。
