VSCode中子模块目录为空或灰色是Git未拉取内容所致，需执行git submodule init && git submodule update --recursive；子模块更新后须cd进入并git pull，再git add && git commit更新指针；多根工作区可使子模块出现在SCM下拉菜单。
VSCode里子模块目录显示为空或灰色图标
这不是 VSCode 故障，而是 Git 本身没把子模块内容拉下来。VSCode 只展示文件系统真实状态，它不会替你执行 git submodule update。
常见现象：克隆完主仓库后，子模块文件夹存在但空着，图标灰掉；git status 不报错，但 git submodule status 显示带 - 前缀（未初始化）。
- 进项目根目录，运行
git submodule init && git submodule update --recursive - 如果子模块 URL 不可访问（比如公司内网、GitHub 私库权限不足），先确认
git ls-remote <submodule-url>能返回结果 - Windows 用户注意路径大小写：.gitmodules 中的
path = libs/MyLib和实际目录名libs/mylib不匹配会导致识别失败 - Git 版本低于 2.20 时
--recursive可能不生效，建议升级到 2.25+
子模块代码更新了，但 VSCode 编辑器里看不到
因为父仓库只存了子模块的 commit SHA，VSCode 不会自动 git pull 子模块内部。它只响应你手动触发的文件系统变更。
Pilot Digital Twin Setup
下载
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
- 必须先进入子模块目录：
cd path/to/submodule - 执行
git pull origin main（或你跟踪的分支） - 回到主目录：
cd .. - 此时
git status会显示modified: path/to/submodule (new commits) - 漏掉
git add path/to/submodule && git commit，别人git pull后仍停留在旧提交
让子模块在 VSCode 源代码管理面板中可选
默认 SCM 面板只显示主仓库，子模块因 .git 是文件而非目录，被 Git 扩展跳过。要让它出现在顶部下拉菜单，必须用多根工作区。
- 关闭当前窗口，新建空白文件夹，用 VSCode 打开
- 执行
File → Add Folder to Workspace…，分别添加主项目和各子模块路径 - 保存为
my-project.code-workspace文件 - 之后双击该文件打开，SCM 顶部就会出现下拉框，可切换查看不同仓库
- 注意：每个根目录独立操作，
git commit不会跨目录批量提交
子模块路径识别异常（尤其 GitToolBox 或 Blame 功能失效）
这类问题本质是插件路径解析逻辑与嵌套子模块结构不兼容，不是 VSCode 配置能直接解决的。
- GitToolBox 等插件依赖
project.basePath计算相对路径，遇到project-root/a/submodule-b会误切前缀 - 临时绕过：在子模块目录单独打开 VSCode 窗口（即把它当独立项目）
- 长期方案：确保
.gitmodules中path值不包含多余斜杠（如libs/ui/改为libs/ui） - 中文路径用户额外检查：
git config --global core.quotepath false，避免路径转义干扰解析
子模块不是“自动同步的子目录”，它是带版本锚点的独立仓库引用。所有变更——初始化、更新、提交指针——都得手动走 Git 流程，VSCode 只负责呈现结果。
