VSCode 1.85+ 默认只显示⎇图标不显示分支名，需启用git.showBranchInStatusBar设置；右键无“Git: Show Branch”说明Git扩展未启用或工作区非仓库根目录；切换分支后显示旧名需手动运行Git: Refresh；多根工作区下状态栏仅绑定第一个根目录。
状态栏只显示⎇图标，不显示分支名（如main、dev）
这是 VSCode 1.85+ 版本的默认行为：UI 自动折叠分支文本，只保留图标。不是功能失效，也不是 Git 没识别到。
必须显式启用 git.showBranchInStatusBar 才能显示文字：
- 打开设置（
Ctrl+,或Cmd+,），搜索git.showBranchInStatusBar，勾选它 - 或直接编辑
settings.json，添加："git.showBranchInStatusBar": true - 该设置仅控制分支名是否显示，不影响 ⎇ 图标、↑2 ↓1 提交状态、修改计数等其他 Git 状态项
- 改完无需重启，但若仍不生效，大概率是工作区未被识别为有效 Git 仓库（见下一条）
右键状态栏找不到“Git: Show Branch”选项
这个菜单项只在两个前提都满足时才出现：Git 扩展已启用 + 当前工作区是有效 Git 仓库根目录。
常见断点排查清单：
- 当前打开的是子目录（如
/project/src），但.git在/project—— VSCode 不自动向上探测，必须打开含.git的文件夹 -
git.enabled被设为false（检查设置中该字段值，确认为true） - Git 扩展被禁用：按
Ctrl+Shift+X，搜Git，确认官方扩展（Publisher:vscode）状态为Enabled - 以上都正常却仍无菜单项？按
Ctrl+Shift+P运行Git: Refresh，强制触发仓库重识别
切换分支后状态栏还显示旧名字
这不是渲染延迟，而是 VSCode 的 Git 监听机制未捕获变更——尤其当你在终端用 git switch 或 git checkout 切换时，编辑器不会自动感知。
解决方式很直接：
- 按
Ctrl+Shift+P运行Git: Refresh，立即更新状态栏显示 - 长期改善：在设置中开启
git.autofetch（设为true），提升远程状态同步灵敏度 - 若频繁复现，检查是否因大量未跟踪文件拖慢监听（比如
node_modules未加进.gitignore） - WSL2 或网络挂载盘环境下，文件系统事件不可靠，只能依赖手动
Git: Refresh
多根工作区下状态栏只显示一个分支
VSCode 状态栏的 Git 状态只绑定**第一个工作区根目录**，不会随当前活动编辑器切换而变化。
这意味着：
- 你同时打开 A 和 B 两个 Git 仓库作为多根工作区，状态栏永远只反映 A 的分支
- 即使你正在编辑 B 里的文件，分支名也不会变成 B 的
- 没有内置设置能改变这一行为；想看 B 的分支，得单独打开 B 文件夹，或使用侧边栏
Git: Branches视图手动切换 - 这个限制在微服务项目中极易被忽略，容易误判当前上下文
状态栏 Git 分支名看似简单，但实际受 Git 仓库识别、扩展启用状态、VSCode 版本策略、多根工作区绑定逻辑四层叠加影响。最容易被跳过的环节是：确认当前打开的是含 .git 的根目录，而不是任意子文件夹。
