VSCode状态栏默认只显示本地分支名，${upstream}是唯一可靠方式显示远程跟踪分支；需在settings.json中配置"git.statusBar.format": "${branch} (${upstream}) • ${changes}"，且仅当分支已设置upstream时生效。
状态栏默认不显示远程分支，${upstream} 是唯一可靠方式
VSCode 状态栏原生只显示当前本地分支名（如 main），远程跟踪分支（如 origin/main）不会自动出现。想让它可见，必须用 git.statusBar.format 配置显式插入 ${upstream} 占位符——这是 VSCode Git 扩展唯一支持的上游分支变量，其他写法（如 ${remote}、${tracking}）均无效。
实操建议：
- 打开
settings.json，确保已启用状态栏："git.statusBar.enabled": true - 添加格式配置：
"git.statusBar.format": "${branch} (${upstream}) • ${changes}" -
${upstream}仅在当前分支设置了 upstream 时才渲染，例如执行过git branch --set-upstream-to=origin/main或通过 VSCode 创建跟踪分支（右键远程分支 → “Create Local Branch From…”） - 若上游未设置，括号内会显示为空，不是 bug，是预期行为
${upstream} 显示内容取决于 Git 的 upstream 设置，不是远程仓库名
${upstream} 展开的是 Git 本地分支的 upstream 引用，格式为 remote-name/branch-name（如 origin/develop），它和你是否能 git push 或 git pull 成功无关，只反映 branch.<name>.merge</name> 和 branch.<name>.remote</name> 这两个 Git 配置项。
常见误解与验证方法：
- 改了远程地址（
git remote set-url origin ...）但没重设 upstream →${upstream}仍显示旧 remote 名 - 执行
git branch -u origin/feat后，${upstream}立即变为origin/feat，无需重启或刷新 - 在终端运行
git config --get branch.main.upstream可直接查看当前分支的 upstream 值，和状态栏显示一致
状态栏显示异常？先确认 upstream 是否真实存在
状态栏中 ${upstream} 没显示、显示为空、或显示为 origin/HEAD，大概率不是 VSCode 配置问题，而是 Git 侧 upstream 未正确建立。
排查步骤：
- 在项目根目录终端运行
git rev-parse --abbrev-ref @{u}—— 若报错no upstream configured，说明当前分支根本没设 upstream - 运行
git branch -vv，看对应分支行末是否带[origin/main]...；若显示[gone]，说明远程分支已被删除，upstream 仍存在但失效 - VSCode 中点击状态栏分支名 → 选择 “Set Upstream” → 选一个远程分支，等价于执行
git branch -u origin/xxx - 避免手动编辑
.git/config，容易格式出错；优先用命令或 VSCode UI 设置
多根工作区下 ${upstream} 只响应激活文件夹的 Git 仓库
如果你用的是多根工作区（multi-root workspace），状态栏的 git.statusBar.format 只对当前“聚焦”的文件夹生效——即编辑器焦点所在的那个根目录下的 Git 仓库。其他根目录即使有 .git，也不会影响状态栏显示。
这意味着：
- 无法在一个状态栏里同时显示多个仓库的分支或 upstream
- 切换编辑器焦点到另一个根目录后，
${branch}和${upstream}会立刻更新为该仓库的值 - 如果某个根目录不是 Git 仓库（无 .git），
${upstream}为空，且整个git.statusBar.format可能完全不渲染（取决于其他占位符是否有效）
复杂点在于：VSCode 不提供跨根目录聚合 Git 状态的能力，${upstream} 的上下文永远是单一、明确的仓库，这点容易被忽略，尤其在大型 monorepo 或混合项目中。
