VSCode通过多根工作区实现多仓库统一识别：新建空文件夹→依次添加各Git仓库文件夹→保存为.code-workspace文件→双击打开即可在SCM视图下拉切换各仓库状态；子模块需单独加入工作区并手动初始化，远程操作依赖Git配置，VSCode仅调用命令。
VSCode 本身不提供“多仓库统一管理”的抽象层，它只是把每个打开的文件夹当作一个工作区——所以你看到多个 Git 仓库，本质上是多个独立项目（或子模块）被同时加载，而非 VSCode 主动管理它们的关系。
怎么让 VSCode 同时识别多个 Git 仓库
VSCode 默认只对当前打开的根文件夹运行 git status。如果想同时看到多个仓库的状态（比如主项目 + 几个子模块），必须用「多根工作区」：
- 新建一个空文件夹，里面不放代码，只用来承载工作区配置
- 在 VSCode 中依次通过 File → Add Folder to Workspace… 添加各个 Git 仓库所在的文件夹（可以是主项目、子模块、甚至完全无关的 repo）
- 保存工作区： File → Save Workspace As…，生成一个
.code-workspace文件 - 之后双击这个文件，所有文件夹会一起加载，源代码管理视图（SCM）顶部会显示下拉菜单，让你切换不同仓库的
git status
注意：每个文件夹仍保持独立的 Git 操作，VSCode 不会帮你批量提交或推送。
子模块在 VSCode 里为什么显示为“未跟踪”或灰色？
这是因为子模块目录本身是一个 gitlink（即 .git 文件是个指向外部 git 目录的文件），而 VSCode 的 Git 扩展默认只扫描 .git/ 目录存在且是文件夹的位置。子模块的 .git 是个文件，不是文件夹，所以被跳过。
- 确保已启用
git.autoRepositoryDetection（默认开启），但即使开启，VSCode 也不会自动把子模块当独立仓库加载 - 正确做法：把子模块所在文件夹也单独加进多根工作区 —— 这样它就能作为独立仓库出现在 SCM 下拉列表中
- 手动初始化子模块内容：终端进入主项目，运行
git submodule update --init --recursive，否则子模块文件夹为空，VSCode 更无法识别
一个仓库配多个远程（origin / upstream / fork）怎么切和推？
VSCode 的推送/拉取操作默认只面向 origin，但它底层调用的是系统 git 命令，所以远程别名本身完全由 Git 配置决定，VSCode 只负责触发。
- 添加额外远程：终端执行
git remote add upstream https://github.com/xxx/repo.git（别名可自定义） - 在 VSCode 的 SCM 视图点击「…」→ Remote → 选择对应远程名，再点 Pull 或 Push 即可
- 若要推到非 origin 远程的特定分支：先在源代码管理面板右上角点击分支名，选中目标本地分支 → 点击「…」→ Push to… → 输入
upstream/main这样的 refspec（格式为/ - 注意：VSCode 不支持图形化设置 upstream 跟踪分支，得用命令行：
git branch --set-upstream-to=upstream/main main
容易忽略的关键点
多根工作区里的每个仓库，其 Git 配置（如 user.name、core.autocrlf）仍是各自 .git/config 或全局配置决定的，不会因为加进同一个工作区就共享设置；子模块的提交历史与主项目完全隔离，VSCode 不会显示跨仓库的 commit 关联；如果你依赖 CI/CD 工具链，务必确认它们是否支持多根工作区结构——大多数只认单个 .git 根目录。
