git ls-remote --heads origin是查看远程分支真实状态最轻量、最可靠的方式，直连远程仓库读取refs/heads/下原始引用，不依赖本地缓存、不拉代码、不触发fetch，适合CI脚本或快速验证分支存在性。
git ls-remote 查看远程分支的原始引用
直接查远程仓库当前有哪些分支，最轻量的方式是不拉取代码、只获取远程引用列表。git ls-remote 会连接远程仓库并列出所有 ref（包括分支、标签），适合快速确认远端是否存在某个分支，尤其在 CI 或脚本中用得上。
常见错误是误以为 git ls-remote origin 默认只显示分支——它其实返回全部 refs，需手动过滤：
- 只看分支：用
git ls-remote --heads origin - 只看 tags：用
git ls-remote --tags origin - 注意：输出中分支名带
refs/heads/前缀，比如refs/heads/main，实际分支名是main - 该命令不依赖本地
fetch状态，即使你从没git fetch过也能查，但需要网络连通且有读权限
git remote show origin 显示分支跟踪关系
想了解本地分支和远程分支的对应关系（比如哪个本地分支 track 哪个远程分支）、哪些远程分支已存在但本地没创建对应分支，git remote show origin 是最直观的命令。
它会主动 fetch 一次 HEAD 和 refs（类似轻量级 fetch），然后结构化输出：
- 列出
Remote branches（远程所有分支） - 列出
Local branches configured for 'git pull'（已设置 pull 目标的本地分支） - 列出
Local refs to be pushed（已设置 push 目标的本地分支） - 如果某远程分支没被任何本地分支 tracking，它会标为
new (next fetch will store in remotes/origin) - 执行前确保
origin名字正确；若远程名不是origin，替换为实际名字，如git remote show upstream
git branch -r 查看已缓存的远程分支列表
git branch -r 显示的是你本地 .git 中已缓存的远程分支引用（即上次 git fetch 或 git pull 时记录下来的快照），不是实时远程状态。
Git Hub Projects V2
下载
使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段（如状态、迭代、优先级等）时使用此技能。
这个命令快、简单，但容易踩坑：
- 如果远程新建了分支，而你没
git fetch，git branch -r就看不到它 - 如果远程删了某个分支，它仍可能留在本地缓存里（表现为
origin/deleted-branch），需用git remote prune origin清理 - 输出格式是
origin/main、origin/feature/login，不含refs/remotes/前缀，但本质就是refs/remotes/origin/main - 想同时看本地+远程分支？用
git branch -a
为什么 git fetch 后再看才最准
几乎所有“查看远程分支”的操作，最终都依赖本地是否拥有最新远程引用。而 git fetch 是唯一真正同步远程 ref 的动作。
建议流程：先 git fetch origin（或 git fetch --all），再用 git branch -r 或 git ls-remote --heads origin 验证。否则看到的可能是过期信息。
特别注意：
-
git pull=git fetch+git merge，它也会更新远程引用，但会触发合并，不一定需要 -
git fetch origin --prune可以在拉取的同时自动清理已删除的远程分支缓存 - 某些 Git GUI 工具（如 VS Code 源码管理面板）底层也调用
git fetch，但刷新时机不透明，手动 fetch 更可控
远程分支不是“随时可见”的静态列表，而是需要主动同步的状态；漏掉 fetch 这步，后面所有查看结果都可能滞后。
