git branch -vv 是查看本地分支与远程分支跟踪关系的最常用命令，可显示分支名、提交ID、上游分支、ahead/behind状态及提交说明；未设置上游时显示 [no upstream]，数值准确性依赖 git fetch --prune 同步远程状态。
git branch -vv 显示分支追踪关系和提交偏移
直接运行 git branch -vv 就能一次性看到所有本地分支的上游（upstream）配置、当前提交哈希，以及「落后多少」[behind N]、「领先多少」[ahead M]。这是最轻量、最常用的方式，不需要额外参数或切换分支。
常见错误是只用 git branch（不带 -v），结果看不到任何远程追踪信息；或者误以为 git status 能显示所有分支的状态——它只报告当前所在分支。
-
-vv是关键：单个-v只显示简略哈希，必须双v才触发上游和 ahead/behind 计算 - 输出中类似
main 1a2b3c4 [origin/main: ahead 2, behind 1]表示该分支已提交 2 次但没推，且 origin/main 有 1 次新提交没拉 - 如果某分支没有 upstream，对应位置显示为
[no upstream]，不是 bug，而是尚未设置追踪
git rev-list --count 判断具体落后/领先数值
当 git branch -vv 显示 [ahead 5, behind 3] 但你想确认是否准确，或脚本里需要精确数字时，得用底层命令验证。因为 ahead/behind 是基于 reflog 和远程 ref 的快照计算的，偶尔会因 fetch 不及时而滞后。
真正可靠的做法是手动比对提交范围：
- 落后数（remote 有但本地没有）：
git rev-list --count HEAD..origin/main - 领先数（本地有但 remote 没有）：
git rev-list --count origin/main..HEAD - 注意方向：两个点之间是「左不包含、右包含」，
A..B表示「从 A 不可达、但 B 可达的所有提交」 - 如果分支没设 upstream，
origin/main需换成你实际要对比的远程引用，比如upstream/develop
git config --get-regexp branch.*.remote 定位追踪配置源头
分支的 upstream 不是魔法生成的，而是存在 Git 配置里。有时 git branch -vv 显示了 upstream，但 push/pull 行为异常，说明配置可能被多处覆盖（比如 .git/config 和全局 config 冲突）。
查清楚到底是谁在控制这个分支的追踪关系：
- 列出所有分支级 remote 配置：
git config --get-regexp "branch\..*\.remote" - 再查对应 merge 配置：
git config --get-regexp "branch\..*\.merge" - 例如输出
branch.main.remote origin和branch.main.merge refs/heads/main，就说明 main 分支追踪origin/main - 如果某分支没出现在结果里，说明它根本没设 upstream，
git branch -u origin/xxx才是正确设置方式
fetch 后状态未更新？别忘了 git fetch --prune
git branch -vv 显示的 ahead/behind 数值依赖本地对远程分支的缓存（即 origin/xxx 引用）。如果远程分支已被删除或重写，而你没清理本地 stale tracking refs，就会看到过期甚至错误的「behind」提示。
- 默认
git fetch不会删除本地已不存在的远程分支引用，导致origin/old-feature还躺在本地 - 加
--prune（或配fetch.prune=true）才能同步远程真实状态：git fetch --prune origin - 执行后，再跑
git branch -vv，那些已删的远程分支会消失，剩余的 ahead/behind 才反映真实差异 - 尤其团队用 squash merge 或 force-push 时，stale refs 会导致「明明刚 pull 过却还显示 behind」这类迷惑现象
追踪配置本身不难查，但 ahead/behind 的数值是否可信，取决于你 fetch 的时机和是否 prune。很多人卡在「显示 behind 却 pull 不下来新提交」，问题往往不在分支设置，而在本地远程引用没同步。
