点状态栏分支名后应选“Checkout to…”切换已有分支，“Create Branch…”用于新建分支；若目标分支未显示，需先执行Git: Fetch同步远程分支或检查本地是否存在。
状态栏点击分支名后弹出的菜单里，“Checkout to…”是切换已有分支的正确选项；“Create Branch”才是新建分支用的，别选错。
点状态栏分支名后，菜单里该选哪个？
VSCode 状态栏左下角点击当前分支（如 main）后弹出的菜单，本质是 Git 操作的快捷入口。它不叫“切换分支菜单”，而是一组上下文操作项：
-
Checkout to…：切换到本地已存在的分支（包括已跟踪的远程分支，如origin/feature/login） -
Create Branch…：新建本地分支，等价于git switch -c <name>，默认基于当前HEAD -
Create Local Branch From…（右键远程分支时才出现）：从远程分支创建并跟踪，等价于git switch --track origin/feature/login -
Publish Branch：把当前本地分支推送到远程，仅对未发布的分支可见
常见错误是看到 Create Branch… 就点——结果新建了个同名分支却没切过去。想切到 develop，就该选 Checkout to…，然后在列表里找 develop。
为什么点了 Checkout to… 却找不到目标分支？
不是菜单坏了，而是分支还没进 VSCode 的本地缓存。VSCode 不会自动同步远程分支列表，它依赖 Git 命令输出。以下情况会导致目标分支不显示：
- 远程有新分支（如
origin/hotfix/1.2.3），但你没运行过git fetch—— 此时按Ctrl+Shift+P输入Git: Fetch即可 - 分支名输错了，比如把
feat/auth手误成feaut/auth—— 弹出菜单支持输入过滤，敲前几个字母试试 - 该分支只存在于其他克隆仓库中，当前本地压根没记录 —— 运行
git branch -r在终端确认是否存在 - VSCode 启用了
git.ignoreLimit或项目过大，导致git for-each-ref超时卡住 —— 可临时禁用大文件夹监听，或手动刷新：Git: Refresh Repository
Checkout to… 选中后报 “Your local changes would be overwritten” 怎么办？
这个错误信息来自 Git 内核，不是 VSCode 拦截的。它说明你有未提交的修改，而目标分支在相同路径下有不同内容。VSCode 不会自动 stash，也不会覆盖，它只是把 Git 的拒绝行为透传出来：
- 如果改的是临时调试代码，点源代码管理视图（
Ctrl+Shift+G）→ 勾选文件 → 点垃圾桶图标Discard Changes - 如果改的是有效开发内容，点提示框里的
Stash（不是Switch Anyway）—— 后者实际是 abort，且可能残留冲突标记 - 千万别在有未保存编辑器 tab 时切分支：VSCode 不会自动重载文件内容，
src/utils.js切完还是旧分支的代码，得手动重新打开或保存触发重读
多根工作区里状态栏只显示一个分支，怎么切另一个文件夹的分支？
VSCode 的 Git 扩展一次只管理一个“活动”文件夹。多根工作区中，只有被设为“主文件夹”或显式添加的含 .git 的路径才会出现在状态栏：
- 资源管理器中右键另一个 Git 文件夹 →
Reopen Folder in New Window，单独开窗口操作 - 或者，在当前窗口按
Ctrl+Shift+P→ 输入Git: Close Repository，先关闭当前 Git 上下文，再打开目标文件夹 - 注意：
git.showBranchInStatusBar是全局设置，但它只对当前激活的 Git 工作区生效；另一个文件夹即使有.git，只要没被聚焦，状态栏就不会切换显示
真正容易被忽略的是：VSCode 切分支不会触发已打开文件的实时内容更新，也不会自动保存。哪怕你点了 Checkout to… 成功，那个正在编辑的 index.ts tab 仍是上一分支的快照——得手动保存、关闭再打开，或启用 files.autoSave 配合 git.autofetch 缓解延迟。
