git branch -r 显示的是本地已知的远程追踪分支（如 origin/main），即 .git/refs/remotes/origin/ 下的只读缓存指针，非远程仓库实时状态。
远程追踪分支不是“远程分支本身”，而是你本地对远程分支状态的缓存快照；它不能直接修改，也不能 checkout，但它是 git pull 和 git push 的默认依据。
git branch -r 显示的是什么
git branch -r 列出的是本地已知的远程追踪分支，比如 origin/main、origin/feature/login。这些名字实际对应 .git/refs/remotes/origin/main 下的文件，是 Git 自动维护的只读指针。
- 它不等于远程仓库当前真实分支列表 —— 如果别人刚推了新分支，而你没
git fetch过，git branch -r就看不到 - 它也不反映远程分支是否已被删除 —— 删除后本地仍会残留，直到你显式清理
- 输出里出现
origin/HEAD -> origin/main是符号引用，表示远程默认分支，不影响操作逻辑
git ls-remote --heads origin 查远程真实分支
想绕过本地缓存、直连远程仓库查分支名和最新提交哈希，用 git ls-remote --heads origin。它不拉代码、不改本地状态，适合快速确认：
- 远程是否存在某分支（比如
feature/v2） - 某分支最新提交 ID 是否与你本地
origin/feature/v2一致（对比哈希值） - CI/CD 脚本中做分支存在性判断，避免依赖可能过期的本地引用
注意：如果返回空或报 fatal: unable to access，大概率是网络不通、token 过期或权限不足，不是命令写错了。
远程追踪分支怎么更新和清理
远程追踪分支由 Git 在网络操作时自动更新，但前提是你要主动触发同步：
-
git fetch origin：拉取所有远程分支最新状态，并移动对应origin/*指针 -
git fetch --prune origin（或git fetch -p）：除了拉取，还删掉本地已不存在对应远程分支的origin/deleted-branch条目 -
git remote set-branches origin 'main' 'develop'：限制后续git fetch只同步指定分支，减少冗余引用（适合大型仓库） - 设为全局默认：
git config --global fetch.prune true，之后每次git fetch都自动 prune
误删了某个 origin/*？没关系 —— 它只是缓存，再 git fetch 就能恢复；但本地分支（如 main）及其提交不会受影响。
为什么 git branch -vv 显示 [gone] 却还能 push
当 git branch -vv 输出类似 feature/x abc123 [origin/feature/x: gone]，说明本地分支 feature/x 曾经跟踪 origin/feature/x，但现在该远程分支已被删除。
- 这个状态不影响你
git push origin feature/x—— Git 会直接在远程创建同名分支 - 但下次
git pull会失败，提示 “no tracking information” - 正确做法是先解除无效跟踪：
git branch --unset-upstream feature/x，再按需重新设置：git branch -u origin/feature/x - 别手动删
.git/refs/remotes/origin/feature/x文件 —— 用git fetch --prune或git remote prune origin更安全
最常被忽略的一点：远程追踪分支的命名空间（如 origin/）是硬编码进 Git 引用路径的，它和远程仓库名强绑定；改了远程名（比如 git remote rename origin upstream），所有 origin/* 引用就失效了，必须重新 fetch 才能生成 upstream/*。
