VSCode多仓库管理依赖多根工作区而非SCM面板开关：需通过“Add Folder to Workspace”添加各.git目录并保存.code-workspace文件；SCM顶部下拉框控制操作作用域；应禁用git.autoRepositoryDetection以防误识别；批量操作推荐终端脚本而非UI。
VSCode 的 Source Control（SCM）视图本身不“管理”多仓库，它只是按工作区结构识别并展示每个 .git 目录的状态——真正起作用的是你如何组织工作区，而不是 SCM 面板的某个开关。
多根工作区是唯一可靠的前提
没有 .code-workspace 文件，VSCode 默认只识别当前打开的**单个文件夹**下的 .git。即使你手动打开了多个窗口，或把几个仓库放在同一父目录下，SCM 视图也不会自动聚合它们。
- 必须通过
File > Add Folder to Workspace…逐个添加含.git的目录（不能只添加父目录） - 添加完毕后务必执行
File > Save Workspace As…，生成my-projects.code-workspace这类文件 - 下次直接双击该文件，或运行
code my-projects.code-workspace，才能恢复全部仓库上下文 - 如果资源管理器里只显示一个根文件夹图标，说明没走多根流程，SCM 也只会显示一个仓库
SCM 视图顶部下拉菜单决定操作作用域
点击左侧 Source Control 图标后，顶部会出现一个下拉框，默认显示当前编辑器焦点所在的仓库路径。这个选择直接控制所有按钮行为：
- 点
✓ Commit：只提交当前下拉选中的那个仓库的暂存变更 - 点
Pull或Push：只对当前选中仓库执行，不会跨仓库误操作 - 右键某个仓库条目 →
Open in Terminal：终端会自动cd到该仓库根目录，避免手动git -C - 如果下拉菜单为空或只有一项，检查是否漏加文件夹，或某个仓库根目录下缺失
.git
常见 Git 自动探测干扰需手动关闭
VSCode 默认开启 git.autoRepositoryDetection，它会递归扫描整个工作区找 .git，容易把子模块、临时构建目录甚至 node_modules/.git 误识别为独立仓库，导致 SCM 显示混乱或卡顿。
- 打开设置，搜索
git.autoRepositoryDetection - 设为
subfolders：仅检测一级子目录，适合扁平结构（如./client、./server） - 设为
false：完全禁用自动探测，靠手动添加确保精准——这是多人协作项目最稳的选择 - 禁用后，若某个仓库没出现在 SCM 中，右键其文件夹 →
Git: Open Repository in Parent Folder
批量操作别依赖 SCM 面板，用终端脚本更可控
SCM 视图不提供“全部拉取”或“全部提交”按钮。强行在 UI 上逐个切换仓库操作，效率低且易漏。真实场景中，你应该用集成终端写轻量脚本：
for d in */; do [ -d "$d/.git" ] && echo "=== $d ===" && git -C "$d" pull; done
- 把所有仓库放在同一父目录下（如
~/repos/），上述命令就能安全遍历 -
git -C确保路径准确，比在每个仓库里开单独终端更省资源 - VSCode 终端支持分栏（
Ctrl+Shift+5），可并行观察多个仓库输出 - 注意：不要在 SCM 视图里点“全部暂存”，它只对当前选中仓库生效，且不会跨文件夹
多仓库管理真正的复杂点不在 UI 操作，而在路径边界和 Git 上下文隔离——一旦某个仓库被错误地嵌套进另一个仓库的子目录（比如 ./backend/app/.git），VSCode 就可能把它当作子模块而非独立仓库，这时 .code-workspace 添加无效，必须调整目录结构或显式配置 git.workingDirectory。
