VSCode多仓库管理需通过多根工作区显式配置，禁用自动探测（git.autoRepositoryDetection设为false或subfolders），并使用.code-workspace文件启动；SCM下拉菜单控制操作作用域，批量操作应使用终端脚本。
VSCode 本身不自动识别父目录下的多个 .git 文件夹——你看到的“多个仓库”必须由你显式定义，否则 SCM 视图只会聚焦当前编辑器所在文件所属的那个仓库。
多根工作区是唯一生效前提，不是可选项
VSCode 的源代码管理（SCM）视图从不递归聚合子目录里的 Git 仓库。比如你打开 ~/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 视图顶部下拉框中应列出全部仓库路径
git.autoRepositoryDetection 必须设为 false 或 subfolders
默认值 true 会让 VSCode 递归扫描整个工作区，把 node_modules/.git、build/.git、甚至子模块里残留的 .git 文件（非目录）误识别为独立仓库，导致 SCM 卡顿、状态错乱、下拉菜单出现灰色无效条目。
- 项目结构扁平（如
./app、./api、./infra并列）→ 设为false，完全禁用自动探测 - 项目有明确一级子目录层级，且确定只有这些子目录含真实仓库 → 设为
subfolders - 设为
false后，若某个仓库没出现在 SCM 中，右键其文件夹 →Git: Open Repository in Parent Folder
SCM 顶部下拉菜单决定操作作用域
这个下拉框不是“展示开关”，而是所有 Git 操作的实际控制开关：点 Pull、Push、Commit 都只对当前选中的那个仓库生效，不会跨仓库误操作。
- 点击下拉框可快速切换当前上下文，但不会自动跳转到对应仓库的文件 —— 如果想聚焦某仓库的变更，需手动打开它里面的任意文件，或右键仓库条目 →
Reveal in Source Control - 右键某个仓库条目 →
Open in Terminal，终端会自动cd到该仓库根目录，比手动git -C更可靠 - 如果下拉菜单为空或只有一项，说明漏加文件夹，或某个文件夹内缺失有效的
.git目录（比如只是空文件、或被files.exclude隐藏了）
批量 Git 操作别碰 UI，终端脚本才是正解
SCM 视图顶部下拉菜单只控制当前操作作用域，它不提供“全部拉取”“全部提交”按钮。试图手动切换每个仓库点一遍 Pull，不仅效率低，还容易漏掉某个仓库或点错目标远程。
- 推荐写个简单脚本（macOS/Linux）：
for repo in client server shared; do echo "=== $repo ==="; git -C "$repo" pull; done
- 把多个仓库放在同一父目录下，脚本能直接遍历；也可用
find . -maxdepth 1 -type d -name "*"动态发现 - VSCode 终端支持分栏，你可以同时开多个终端并行观察输出，比 UI 点击更可控
真正容易被忽略的是路径变更后的同步维护：一旦某个仓库被移动或重命名，.code-workspace 文件里的路径就失效了，VSCode 会提示缺失，但不会自动修复——你得手动编辑 JSON 或从工作区中移除再重新添加。
