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