VSCode右下角不显示Git分支名，通常因git.showBranchInStatusBar设为false或状态栏Git项被隐藏；需开启该设置或右键状态栏勾选“Git: Show Branch”，并确保工作区为有效Git仓库根目录。
VSCode右下角状态栏不显示Git分支名，基本就是git.showBranchInStatusBar被关了，或者状态栏项被手动隐藏了——不是插件问题，也不是Git坏了，95%的情况改一个设置或点一下鼠标就能恢复。
状态栏完全不显示分支名（连⎇图标都没有）
这说明VSCode根本没把当前工作区识别为Git仓库，或者Git扩展没启用：
- 检查左下角是否显示 Git 图标（⎇）：没有 → 当前打开的不是 Git 仓库根目录（比如只打开了单个
.js文件，而不是含.git文件夹的整个项目文件夹） - 按
Ctrl+Shift+P运行Git: Refresh，看是否触发识别 - 打开扩展面板（
Ctrl+Shift+X），搜Git，确认官方扩展（Publisher:vscode）已启用 - 在终端里执行
git rev-parse --git-dir，确认当前路径下确实存在.git
状态栏只显示⎇图标，不显示main、dev这类文字
这是 VSCode 1.85+ 的默认行为：分支名文本被UI自动折叠，只留图标。要强制显示文字，必须显式开启设置：
Convert Github Repository
下载
适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……
- 打开设置（
Ctrl+,），搜索git.showBranchInStatusBar - 勾选它，或直接在
settings.json中添加："git.showBranchInStatusBar": true
- 该设置仅控制“分支名是否显示”，不影响图标、修改计数（如
1 modified）或提交状态 - 改完无需重启，但若仍不生效，大概率是工作区未被识别为仓库（见上一条）
右键状态栏找不到Git: Show Branch选项
这不是设置问题，而是状态栏的 Git 状态项被整体隐藏了：
- 右键点击状态栏任意空白处（比如时间、
UTF-8、LF那块区域） - 在弹出菜单中找
Git: Show Branch并勾选 —— 如果没看到，说明 Git 扩展未启用，或当前无有效仓库 - 极少数情况是多根工作区（multi-root workspace）导致状态栏只响应其中一个文件夹；此时需确保你操作的是 Git 仓库所在的那个根目录
切换分支后状态栏还显示旧分支名
VSCode 的 Git 状态监听有延迟，尤其当你用终端命令（git switch / git checkout）切分支时，编辑器不会自动感知：
- 手动按
Ctrl+Shift+P运行Git: Refresh即可立即更新 - 开启
git.autofetch（设为true）能提升响应灵敏度，但不能完全替代手动刷新 - 如果频繁复现，检查是否有大量未跟踪文件（如
node_modules），建议在.gitignore中排除它们 - WSL2 跨 distro 访问、网络挂载盘等场景下，文件系统事件不可靠，只能依赖
Git: Refresh
最常被忽略的一点：这个功能完全依赖「VSCode 打开的是 Git 仓库根目录」这一前提。哪怕路径只差一层（比如开了project/src而不是project），${branch}变量和状态栏分支名都会失效——它不递归查找.git，也不支持子模块自动识别。
