git submodule update 不管用是因为新克隆仓库未初始化子模块配置，需先 git submodule init 将 .gitmodules 写入 .git/config，再执行更新；更优解是直接运行 git submodule update --init --recursive 一次性完成初始化、拉取及嵌套子模块递归更新。
子模块目录空着、
没反应、嵌套子模块根本没拉下来——这不是 VSCode 的锅，而是 Git 本身不递归、不自动、不猜你意图。默认行为就是“只认指针，不碰代码”，必须显式告诉它：要初始化、要拉取、要钻进嵌套里。
克隆后子模块目录是空的，为什么
不管用
因为
前提是子模块已“注册”到本地配置，而新克隆的仓库里
还没写入子模块信息。
文件只是声明，不是执行指令。
先运行
：把
里的路径和 URL 写进
再运行
：按刚写好的配置去拉代码
更稳妥的做法是一条命令搞定：
（含所有嵌套层级）
VSCode 集成终端里执行时，务必确认当前路径是主仓库根目录（
看一眼，别在子模块目录里瞎敲）
参数到底递归什么，漏掉会怎样
它递归的是“子模块的子模块”，也就是嵌套结构。比如
项目引用了
，而
自己又引用了
，那不加
就只会拉到
，
目录仍是空的。
只用
：只拉一级子模块，
有内容，
是空文件夹
加了
：
和
全部拉满，且各自检出对应提交
注意：
不等于“自动跟踪分支”。子模块仍锁定在主仓库记录的 commit 上，除非你手动进目录
子模块更新后 VSCode 里看不到新文件，怎么办
VSCode 不会主动扫描子模块目录下的文件变化——它只读取 Git 状态，而子模块的 Git 状态藏在
文件（不是文件夹）里，VSCode 默认跳过识别。
Git
程序猿必备版本控制工具
下载
子模块代码确实拉下来了（
能看到），但编辑器里不显示：说明文件系统已就位，只是 SCM 视图没加载
想让子模块出现在左侧源代码管理面板下拉菜单中：必须用「多根工作区」——新建
，通过
Add Folder to Workspace…
把主项目和每个子模块路径都加进去
加完后，SCM 顶部会出现下拉框，可单独查看任一子模块的
，但注意：VSCode 不会帮你批量提交，每个仓库操作仍是独立的
为什么
有时还是失败
强制更新解决的是“本地子模块状态偏离主仓库指针”的问题，但失败往往卡在更底层：网络、权限、路径或悬空提交。
：主仓库记录的 commit
在子模块远程仓库里不存在（比如被 force push 覆盖过）
修复顺序：
→
→
子模块 URL 是 HTTPS 且私有？检查凭据：
，然后跑一次
，让它弹窗输密码并缓存
路径含空格或中文？Git 在某些 Windows 版本下对特殊字符处理不稳定，建议重命名子模块路径为纯英文+下划线
最易被忽略的一点：子模块更新完成后，如果是在子模块里改了代码并提交，主项目不会自动感知——你必须回到主目录，
那个子模块路径，再
，否则别人
后拿到的还是旧指针。这个“二次提交”步骤，90% 的协作问题都栽在这儿。
git submodule updategit submodule updategit submodule update.git/config.gitmodulesgit submodule init.gitmodules.git/configgit submodule updategit submodule update --init --recursivepwd--recursiveABBC--recursiveBCgit submodule update --initBC--recursiveBC--recursivegit pull.gitls path/to/submodule.code-workspacegit statusgit submodule update --force --recursiveFatal: reference is not a tree: abc123abc123git submodule sync --recursivegit fetch --all --recurse-submodulesgit submodule update --force --recursivegit config --global credential.helper storegit submodule updategit addgit commitgit pull