git clone默认不拉取子模块，需用--recurse-submodules参数或后续执行git submodule init && git submodule update --recursive；子模块是独立仓库引用，需手动更新sha-1并提交。
克隆时没拉取子模块，git clone 默认不递归
直接 git clone 一个含子模块的仓库，子模块目录会是空文件夹，甚至显示为灰色图标——这不是 VSCode 的问题，是 Git 本身行为。子模块本质是另一个 Git 仓库的引用，Git 不会自动初始化并检出它。
正确做法是加 --recurse-submodules 参数：
git clone --recurse-submodules https://github.com/xxx/repo.git
如果已经克隆完了，进目录执行：
-
git submodule init—— 初始化 .gitmodules 中记录的子模块配置 -
git submodule update --recursive—— 拉取并检出各子模块对应提交（含嵌套子模块）
VSCode 内置终端 vs 外部终端：命令行为一致，但路径容易错
VSCode 集成终端默认打开的是工作区根目录，但如果你用「在文件夹中打开」却点错了父级目录，git submodule 命令就会报错：fatal: not a git repository (or any of the parent directories)。
确认当前路径正确的最快方式：
- 看终端提示符末尾路径，或运行
pwd - 在 VSCode 左下角状态栏检查是否显示了正确的 Git 分支名（有分支才说明在 Git 仓库内）
- 子模块目录里没有
.git文件（而是.git文件，内容为gitdir: ../.git/modules/xxx），这是正常现象，别误删
子模块更新后 VSCode 不刷新，git status 显示“modified: xxx (new commits)”
这表示父仓库记录的子模块 SHA-1 已过期，但 VSCode 编辑器本身不会自动同步子模块代码。你得手动更新，否则即使子模块远程有新提交，你在编辑器里也看不到。
安全更新流程：
- 进子模块目录，
git pull或git checkout main && git pull - 回到父仓库根目录，
git add xxx（子模块名）—— 这步会把新 SHA-1 记录进父仓库 git commit -m "update submodule xxx to abc123"
跳过第一、二步直接 git submodule update --remote 虽快，但可能拉到不稳定分支，线上项目慎用。
子模块路径含空格或特殊字符，git submodule 报错或 VSCode 无法识别
Windows 下尤其常见：子模块路径写成 libs/my tool，Git 会尝试创建带空格的目录，但某些旧版 Git 或 VSCode 扩展（如 GitLens）解析路径时会截断。
解决办法很直接：
- 重命名子模块路径，去掉空格和中文，例如改为
libs/my_tool - 修改
.gitmodules文件里对应path =行 - 运行
git submodule sync同步配置，再git submodule update --init
改完后务必检查 VSCode 资源管理器里子模块是否显示为可展开的文件夹（而不是灰色不可点）。
子模块不是「自动同步的子目录」，它是独立仓库的快照引用；每次切换分支、回退提交、甚至只是git pull 后，都得心里默念一句：子模块动没动？
