VSCode的SCM面板不显示子模块变更，因其仅监听根仓库的.git和文件变更，而子模块是独立仓库且.git为指向外部的文件，VSCode不递归解析；子模块内修改仅在git status中显示为路径文本，不展开状态、不支持暂存、无diff高亮，所有管理必须通过终端命令完成。
VSCode 本身不原生支持 Git 子模块的图形化操作，所有子模块管理必须通过终端命令完成，UI 界面不会识别、高亮或提供子模块专用交互。
为什么 VSCode 的 SCM 面板看不到子模块变更
VSCode 的源代码管理（SCM）视图只监听当前仓库根目录下的 .git 和文件变更，而子模块本质是独立仓库，其工作区被挂载为普通文件夹，且自身 .git 是文件（指向 ../.git/modules/xxx），VSCode 不递归解析这种嵌套结构。因此：
- 子模块内文件修改后，
git status在父仓库中显示为modified: path/to/submodule (new commits)，但 SCM 面板只显示该行文本，不展开子模块内部状态 - 子模块新增/删除不会触发 SCM 的“Untracked”标记，需手动
git add或git rm - 点击子模块文件名不会打开 diff，只会以普通文本方式打开（无 Git 差异着色）
在 VSCode 终端中正确初始化和更新子模块
子模块生命周期操作必须用命令行，且要注意路径上下文和参数含义：
- 首次克隆含子模块的仓库后，运行
git submodule init初始化配置，再运行git submodule update拉取代码 —— 缺一不可 - 更常用的是一步到位：
git clone --recurse-submodules <url></url>，但仅对新克隆有效；已有仓库需手动补全 - 更新子模块到最新远程 commit：
git submodule update --remote --merge（注意：不是--rebase，VSCode 终端中默认 shell 不支持 rebase 冲突自动暂停） - 进入子模块目录操作前，先确认是否已检出分支：
cd path/to/submodule && git branch；若为 detached HEAD，建议git switch main再提交
如何避免子模块提交丢失或引用错乱
子模块的 commit ID 是父仓库的“快照引用”，任何在子模块内的提交都不会自动更新父仓库记录：
- 在子模块中修改并提交后，必须回到父目录执行
git add path/to/submodule，否则父仓库仍指向旧 commit -
git commit -m "update submodule"这一步不能省略，否则推送后其他协作者git pull不会同步子模块变更 - 不要直接在父仓库中
git checkout切换子模块分支 —— 这会导致子模块处于 detached HEAD，后续提交易丢失 - 检查子模块状态统一用：
git submodule status（输出每行开头的-表示未初始化，+表示本地 commit 与父记录不一致，
VSCode 中编辑子模块代码的实际体验限制
虽然可以正常打开、编辑子模块内文件，但关键功能受限：
- 侧边栏 SCM 不显示子模块内文件的修改状态，无法一键暂存（
Stage Changes对子模块路径无效） - 右键菜单中 “Git: Stage Selected Ranges”、“Git: Revert Selected Ranges” 等选项对子模块文件不可用
- 如果子模块有自己独立的 VSCode 工作区配置（如
.vscode/settings.json），它不会被父工作区继承，需单独打开子模块文件夹才能生效 - 调试器断点、扩展插件（如 ESLint、Prettier）可能因子模块路径未纳入父工作区
"files.associations"或"eslint.workingDirectories"而失效
子模块不是“透明集成”的功能，它是 Git 的底层机制，VSCode 只做最小兼容。真正要可靠协作，得把子模块当成独立项目来管：每次变更都明确走“子模块内提交 → 父仓库中更新引用 → 父仓库提交”三步，少依赖 UI，多信终端输出。
