终端提示符需实时显示git分支领先/落后提交数，因git status仅手动触发且非实时；应通过封装函数调用git fetch与rev-list动态计算，并在ps1/prompt中引用，避免卡顿与缓存误差。
Git分支状态为什么不能只靠 git status 实时看？
因为每次敲命令才查一次，而你在写代码、切文件、切窗口时根本不会主动去查。真正需要的是：终端提示符（PS1）里直接显示当前分支比远程「超前 X 提交」、「落后 Y 提交」——而且这个数字得是实时的，不是上次 git fetch 之后的缓存结果。
用 git rev-list --count 获取领先/落后提交数
Git 没有内置「一键算差值」的命令，但可以用两个 git rev-list --count 组合出来：
-
git rev-list --count HEAD..origin/$(git rev-parse --abbrev-ref HEAD)→ 落后数（本地没拉下来的提交） -
git rev-list --count origin/$(git rev-parse --abbrev-ref HEAD)..HEAD→ 领先数（本地多出的提交）
注意必须用 $(git rev-parse --abbrev-ref HEAD) 而不是硬编码 main 或 master，否则切换分支就失效；也别用 git branch --show-current，它在 detached HEAD 下会输出空，导致命令崩溃。
zsh / bash 中让 PS1 实时调用并缓存结果
直接把上述命令塞进 PS1 会导致每次光标移动都执行一次，卡顿明显。正确做法是：用 shell 函数封装 + 每次命令执行后更新变量 + 在提示符中引用变量。
以 zsh 为例，在 ~/.zshrc 里加：
parse_git_branch_status() {
local branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
if [ -n "$branch" ] && git remote | grep -q '^origin$'; then
git fetch -q origin "$branch" 2>/dev/null
local behind=$(git rev-list --count HEAD..origin/$branch 2>/dev/null || echo 0)
local ahead=$(git rev-list --count origin/$branch..HEAD 2>/dev/null || echo 0)
if [ $behind -eq 0 ] && [ $ahead -eq 0 ]; then
echo ""
else
echo " $(($ahead > 0 ? $ahead : 0))↑$(($behind > 0 ? $behind : 0))↓"
fi
fi
}
PROMPT='%F{blue}%n%F{white}@%F{green}%m %F{yellow}%~ %F{cyan}$(parse_git_branch_status)%f%# '
关键点：git fetch -q origin "$branch" 确保数据最新，但只 fetch 当前分支对应远程 ref，避免全量同步拖慢；$(...) 在 PROMPT 中是每次渲染时执行，所以函数内已包含 fetch 和计算逻辑。
常见坑：Windows Git Bash、WSL、oh-my-zsh 插件冲突
Windows Git Bash 默认用 mintty，不支持 true color，且 git fetch 可能因权限或代理失败，建议加 2>/dev/null 并设超时：git -c core.askpass= fetch -q --timeout=3 origin "$branch" 2>/dev/null。
WSL 下如果提示符乱码，检查 locale 是否为 UTF-8（locale | grep UTF），不是就加 export LANG=en_US.UTF-8 到配置文件。
用了 oh-my-zsh 的 git 插件？它自带 git_prompt_info，但默认不显示领先/落后数——得关掉插件，或重写它的 git_prompt_status 函数，否则两个逻辑打架，分支名重复显示或状态错位。
最麻烦的其实是「远程名不是 origin」的项目，比如用 upstream 做主远程。这时候不能硬写 origin/，得先用 git config --get branch.$(git rev-parse --abbrev-ref HEAD).remote 动态取远程名，再拼接。
