先确认 git 面板是否已激活：点击左侧源代码管理图标或按 ctrl+shift+g；若无响应，说明当前文件夹非 git 仓库根目录，需用“文件→打开文件夹”定位到含 .git 的目录，或执行 git: initialize repository。
VSCode侧边栏不显示分支列表？先确认 Git 面板是否已激活
点击左侧活动栏的 源代码管理 图标（分支形状），或按 Ctrl+Shift+G（Windows/Linux）/Cmd+Shift+G（macOS）。如果没反应，说明当前打开的文件夹不是 Git 仓库根目录——VSCode 不会自动初始化，必须手动执行 Git: Initialize Repository（通过 Ctrl+Shift+P 调出命令面板输入）。
常见错误现象：Source Control 面板顶部空白、无分支按钮、BRANCHES 区域不展开。此时检查终端运行 git status 是否报 fatal: not a git repository，是则需重新用“文件 → 打开文件夹”定位到含 .git 的目录。
侧边栏里“BRANCHES”区域不出现？检查 Git 扩展状态和设置
VSCode 内置 Git 支持，但依赖 Git CLI 可执行路径正确配置。若 git branch 在终端能运行，但在侧边栏看不到分支列表，大概率是 Git 扩展被禁用或路径异常。
- 打开设置（
Ctrl+,），搜索git.path，确认值为 Git 可执行文件绝对路径，例如/usr/bin/git（Linux/macOS）或C:\Program Files\Git\bin\git.exe（Windows） - 在扩展面板中搜索
Git，确保官方Git扩展（Publisher:vscode.git）已启用且未被其他 Git 插件覆盖 - 某些工作区设置了
"git.enabled": false，需在工作区settings.json中删掉或改为true
侧边栏分支列表只显示当前分支，看不到远程分支？需要手动展开
VSCode 的 BRANCHES 区域默认收起远程分支。点击该区域右上角的 ⋯（更多操作按钮），选择 Fetch from Origin 或 Sync Changes，之后再点击 Remote Branches 左侧的三角箭头即可展开。
注意：远程分支不会自动同步刷新。如果刚在别处推送了新分支，仅靠点击分支下拉菜单不会更新列表，必须先 Fetch。命令行等效操作是 git fetch origin --prune，对应 VSCode 中的 Git: Fetch 命令（Ctrl+Shift+P 输入）。
想让侧边栏始终显示完整分支结构？避免误关折叠状态
侧边栏的 BRANCHES 是可折叠区域，右上角有 − 按钮。一旦点过，它会记住收起状态，重启 VSCode 后仍为空白——这不是 Bug，是持久化 UI 状态。
恢复方法很简单：
- 鼠标悬停在
BRANCHES文字上方，出现下划线时点击，或直接点击其右侧的+展开图标 - 若整个
BRANCHES区域消失（只剩STASHES和COMMITS），说明被手动隐藏了：右键侧边栏空白处 → 选择Show Branches - 该设置保存在工作区
settings.json中，字段名为"git.showBranchList"，设为true即可强制显示
真正容易被忽略的是：分支列表展开后，右键某一分支才能看到 Merge into Current Branch 或 Rebase Current Branch onto... 这类关键操作——不展开，这些选项根本不会出现在右键菜单里。
