VSCode状态栏不显示分支名说明未识别为Git仓库，常见原因有三：未打开仓库根目录、Git扩展未启用、.git目录不存在；仅显示⎈图标是1.85+默认行为，需开启git.showBranchInStatusBar设置；右键无Git选项则Git扩展未启用或无有效仓库；切换分支后显示旧名需手动执行Git: Refresh。
状态栏完全不显示分支名（连 ⎇ 图标都没有）
这说明 VSCode 根本没把当前工作区识别为 Git 仓库，不是设置问题，也不是插件故障。常见原因有三个：
- 打开的不是仓库根目录——比如只打开了
src/index.js，而.git在上层my-project/目录里 - Git 扩展未启用：按
Ctrl+Shift+X搜Git，确认官方扩展（Publisher:vscode）已启用 -
.git目录确实不存在：在终端执行git rev-parse --git-dir，若报错fatal: not a git repository，说明当前路径不是仓库
验证方式：看左下角有没有 ⎇ 图标。没有，就先关掉 VSCode，重新用文件夹方式打开含 .git 的完整项目目录。
状态栏只显示 ⎇ 图标，不显示 main、dev 这类文字
这是 VSCode 1.85+ 的默认行为：分支名文本被 UI 自动折叠，只留图标。要强制显示文字，必须显式开启设置：
- 按
Ctrl+,打开设置，搜索git.showBranchInStatusBar - 勾选它；或直接在
settings.json中添加："git.showBranchInStatusBar": true
该设置只控制“是否显示分支名文本”，不影响 ⎇ 图标、修改计数（如 2 modified）或提交状态。改完无需重启，但若仍不生效，大概率是工作区未被识别为仓库（见上一条）。
右键状态栏找不到 Git: Show Branch 选项
这不是设置缺失，而是 Git 状态项被整体隐藏了：
- 右键点击状态栏任意空白处（比如时间、
UTF-8、LF那块区域） - 在弹出菜单中找
Git: Show Branch并勾选 - 如果菜单里根本没这个选项，说明 Git 扩展未启用，或当前无有效仓库（不是路径问题就是扩展禁用了）
多根工作区（multi-root workspace）下，VSCode 只响应你当前激活的那个根目录。确保你操作的是含 .git 的那个文件夹。
切换分支后状态栏还显示旧分支名
VSCode 的 Git 状态监听有延迟，尤其当你用终端命令（git switch 或 git checkout）切分支时，编辑器不会自动感知：
- 手动按
Ctrl+Shift+P运行Git: Refresh即可立即更新 - 开启
git.autofetch（设为true）能提升响应灵敏度，但不能完全替代手动刷新 - 如果频繁复现，检查是否有大量未跟踪文件（如
node_modules），建议在.gitignore中排除它们
状态栏显示逻辑完全依赖 git status -sb 输出，终端里看到什么，VSCode 就显示什么。两者不一致，八成是你在子目录里启动了 VSCode，或者扩展上下文加载失败——关掉重开一次常能解决。
