VSCode不支持一键跨仓库切分支，必须先通过多根工作区显式配置多个仓库，并在SCM下拉菜单中选定作用域后，再对当前仓库执行分支操作；单仓库内可通过状态栏点击、命令面板或快捷键切换分支。
VSCode 本身不支持“一键跨仓库切分支”，必须先明确当前操作作用域——是单仓库内切分支，还是多仓库间切换后再各自操作分支。两者路径完全不同，混用必出错。
多根工作区是跨仓库操作的前提
你看到的“多个仓库”不是 VSCode 自动发现的，而是你亲手配置出来的。如果只是打开一个父文件夹（如 ~/projects），里面含 client/、server/、shared/ 三个带 .git 的目录，SCM 视图默认只显示其中一个——除非你显式创建多根工作区。
- 逐个执行
File > Add Folder to Workspace…，选每个仓库的**根目录**（不能选~/projects） - 完成后执行
File > Save Workspace As…，生成my-workspace.code-workspace - 下次必须双击该文件启动，或运行
code my-workspace.code-workspace；code .无效 - 验证：资源管理器顶部应显示多个并列文件夹图标；SCM 顶部下拉菜单中列出全部仓库路径
SCM 下拉菜单决定分支操作的实际作用域
这个下拉框不是“显示开关”，而是所有 Git 操作的控制开关：点 Pull、Push、Commit 都只对当前选中的那个仓库生效。它不自动跳转文件，也不聚合状态。
- 点击下拉框可快速切换当前上下文，但编辑器不会自动聚焦该仓库的文件——想看变更，需手动打开其内任意文件，或右键仓库条目 →
Reveal in Source Control - 右键某个仓库条目 →
Open in Terminal，终端会自动cd到该仓库根目录，比手写git -C更可靠 - 若下拉菜单为空或仅一项，检查是否漏加文件夹，或某个文件夹内缺失有效
.git目录（比如被files.exclude隐藏了）
单仓库内快速切换分支的三种可靠方式
状态栏点击分支名、命令面板调用、快捷键绑定，三者本质都是触发 git switch 或 git checkout，但触发条件和限制不同。
- 状态栏左下角分支名（如
main）点击后无响应？先确认.git存在且工作区是仓库根目录；再试Git: Refresh Repository - 按
Ctrl+Shift+P输入Git: Checkout to，列出所有本地分支；远程分支需先Git: Fetch才会出现 - 新建分支并立即检出：用
Git: Create Branch，输入名（如feat/api-v2），回车即完成；分支名避免空格和中文 - 切换前若有未提交更改，VSCode 默认阻止；强制切换需先
Git: Stage All或Git: Discard Changes
批量操作别碰 UI，终端脚本才是正解
SCM 下拉菜单只控制单次操作的作用域，它不提供“对全部仓库执行 pull”这类功能。想批量更新、同步或清理，必须写脚本。
- 例如批量拉取所有仓库最新：在工作区根目录运行循环脚本，对每个子目录执行
git -C ./client pull && git -C ./server pull - VSCode 内置终端右键某仓库 →
Open in Terminal只进一个目录；批量操作必须脱离 UI，在系统终端里执行 - 注意
git.autoRepositoryDetection设置为false或subfolders，否则可能把node_modules/.git等误识别为独立仓库，导致 SCM 卡顿或下拉菜单出现灰色无效项
真正容易被忽略的是：多根工作区配置一旦生成，就必须通过 .code-workspace 文件启动；而分支切换动作永远绑定在“当前作用域仓库”上——你不可能在 SCM 下拉菜单里选中 client 仓库的同时，对 server 仓库执行 push。这种隔离不是缺陷，是设计前提。
