Git Branch Helper

一个面向日常开发的 VS Code Git 分支管理插件。在侧边栏集中展示工作区内各项目的本地分支与远程分支，支持一键同步、切换分支、创建分支等常用操作。

功能概览

• 分支视图：按项目目录分组，展开后可查看「本地分支」与「远程分支」
• 当前分支标识：当前 checkout 的本地分支名称以绿色文字高亮，图标与其他分支一致
• 同步代码：支持 fetch、pull、push 或一键全部执行
• 切换分支：从远程分支列表选择并切换；本地不存在时自动创建跟踪分支
• 创建分支：基于远程分支创建新分支并切换过去
• 多仓库支持：工作区含多个 Git 仓库（含子目录）时自动扫描并分组展示

安装

在 VS Code 扩展面板搜索 Git Branch Helper 安装，或访问：

https://marketplace.visualstudio.com/items?itemName=zhengzhiwei.git-branch-helper

使用说明

打开分支视图

点击活动栏的 Git Branch Helper 图标，在侧边栏打开「分支」视图。

视图结构如下：

项目目录
├─ 本地分支
│  ├─ develop        ← 当前 checkout 分支（绿色文字）
│  └─ feature/xxx
└─ 远程分支
   ├─ origin/develop
   └─ origin/main

视图顶部操作

在分支视图标题栏可使用以下按钮（或通过命令面板调用）：

分支节点右键菜单

在本地分支或远程分支上右键：

项目目录右键菜单

在项目目录节点上右键：

命令面板

按 Ctrl+Shift+P（macOS：Cmd+Shift+P），输入 Git Branch Helper 可找到全部相关命令。

常见问题

视图中没有分支？

确认当前工作区已打开包含 .git 的目录。可先执行「同步代码」中的 fetch 抓取远程分支。

切换远程分支时提示本地不存在？

插件会自动基于远程分支创建同名本地跟踪分支，无需手动操作。

操作失败如何排查？

打开「输出」面板，选择 Git Branch Helper 通道，可查看详细执行日志。

作者

zhengzhiwei — kukaz@qq.com