应执行git submodule update --init --recursive一步补救：先初始化子模块配置，再递归拉取并检出所有子模块内容。
克隆时子模块目录为空，怎么补救
这是最常遇到的问题：直接 git clone 含子模块的仓库后，子模块文件夹是空的，甚至在 VSCode 里显示为灰色图标。这不是 VSCode 的 bug，而是 Git 默认不递归拉取子模块。
如果你已经克隆完了，进项目根目录执行：
-
git submodule init—— 读取.gitmodules，注册子模块配置 -
git submodule update --recursive—— 拉取所有子模块（含嵌套）并检出对应提交
更常用的一条命令是：git submodule update --init --recursive，一步到位。VSCode 集成终端（Ctrl + `）里运行即可，但务必确认当前路径是主仓库根目录（看终端提示符或运行 pwd）。
子模块更新后 VSCode 不显示新代码，为什么
子模块目录里的代码更新了，但你在编辑器里看不到——这是因为父仓库只记录了子模块的 SHA-1 提交哈希，VSCode 不会自动同步子模块工作区。它只反映 Git 状态，不主动刷新文件系统内容。
正确流程是：
- 进入子模块目录：
cd path/to/submodule - 拉取最新代码：
git pull origin main（或你跟踪的分支） - 回到主项目根目录：
cd .. - 运行
git status，你会看到类似modified: path/to/submodule (new commits) - 此时必须
git add并git commit这个变更，才能把新的子模块指针存进主仓库
漏掉最后一步，其他协作者 git pull 后仍会停留在旧提交上。
VSCode 里怎么让子模块也出现在源代码管理面板
默认情况下，VSCode 的 SCM 视图只显示主仓库，子模块目录因 .git 是个文件（不是文件夹），被 Git 扩展跳过识别。
想让它也作为独立仓库出现在 SCM 下拉菜单中，必须用「多根工作区」：
- 新建一个空文件夹，用 VSCode 打开
- 执行
File → Add Folder to Workspace…，分别添加主项目和各子模块所在文件夹 - 保存为
.code-workspace文件（如my-project.code-workspace）
之后双击该文件打开，SCM 顶部就会出现下拉选择框，可切换查看主项目或任一子模块的 git status。注意：每个文件夹仍是独立 Git 操作，VSCode 不会帮你批量提交。
添加新子模块时容易踩的坑
用 git submodule add 引入新子模块后，很多人以为完事了，其实关键步骤常被跳过：
- 必须
git add .gitmodules和git add path/to/submodule（后者是 gitlink，不是文件夹内容） - 必须
git commit -m "add submodule xxx"，否则别人克隆时根本不知道这个子模块存在 - 如果希望子模块始终跟踪某个分支（比如
main），添加时要用--branch main参数：git submodule add -b main https://github.com/user/repo.git path；否则它默认锁定在某个 commit，后续git pull不会自动更新 - 别手动删除子模块目录——应先
git submodule deinit -f path，再rm -rf .git/modules/path和git rm -f path
子模块不是“插件”，它是 Git 层级的引用机制。VSCode 只是展示层，真正要稳，得靠命令行把初始化、更新、提交这三步闭环走完。
