VSCode 中最快切换 Git 分支的方式是点击底部状态栏的当前分支名。点击后弹出本地分支列表,选中即可自动执行 git checkout 并刷新工作区;若提示“dirty working directory”,需先提交或暂存更改;远程分支需先 fetch 才能显示。

VSCode 里查看和切换 Git 分支不需要插件,内置的源代码管理视图就能完成,但很多人没注意到底部状态栏那个不起眼的分支名——它才是最快入口。
点击底部状态栏的 main(或当前分支名)
这是最直接的方式:VSCode 底部蓝色状态栏左侧会显示当前 Git 分支,比如 main、develop 或 feature/login。点击它,会立刻弹出所有本地分支列表,已检出的分支带对勾;选中任意分支,VSCode 会自动执行 git checkout 并刷新工作区。
- 如果列表为空,说明项目还没初始化 Git 或没检测到
.git目录 - 远程分支(如
origin/main)默认不显示,需先运行git fetch,或在弹出菜单里点“Fetch from origin” - 点击后若提示“Unable to switch branches: dirty working directory”,说明有未提交更改,得先
git stash或提交
用命令面板调出分支操作(Ctrl+Shift+P / Cmd+Shift+P)
按快捷键打开命令面板,输入 Git: Checkout to...,回车后列出所有本地分支;输入 Git: Create Branch... 可新建并切换;输入 Git: Merge Branch... 则用于合并而非切换。
-
Git: Checkout to...和底部点击本质一样,适合键盘党或状态栏被隐藏时使用 - 如果输完命令没反应,检查是否在 Git 仓库根目录下打开文件夹(不是子文件夹)
- 新建分支时,VSCode 默认基于当前 HEAD 创建,不支持指定 commit hash,如需更精确控制,仍需终端执行
git checkout -b new-branch
在源代码管理视图里看分支状态
左侧活动栏点源代码管理图标(折叠的分支图标),顶部能看到当前分支名 + 提交数差异(如 main (2 ahead, 1 behind))。展开“BRANCHES”小节,可看到本地分支列表(带提交简写)、远程跟踪分支(灰色,前缀 origin/)以及标签。
- 右键分支名可执行
Merge into Current Branch、Rebase Current Branch onto...等操作 - 远程分支右键有
Checkout选项,但实际执行的是git checkout -b,会自动建立追踪关系--track origin/ - 这个视图不会实时刷新,切换分支后可能需要手动点右上角刷新按钮(或按
Ctrl+R)
git status -sb
VSCode 的分支显示逻辑依赖 git status -sb 输出,所以终端里执行这条命令看到什么,VSCode 状态栏和视图就显示什么。如果你发现 VSCode 显示的分支和终端不一致,八成是工作区打开了错误的文件夹,或者 VSCode 启动时没加载到 Git 扩展上下文——关掉窗口重开一次常能解决。










