如何让VS Code源代码控制视图中Git子模块缩进显示在父仓库下

原生VS Code设置（推荐） #

VS Code 1.70及以上版本提供了原生支持，只需开启一个设置就能实现子模块嵌套缩进：

1. 打开设置面板（快捷键Ctrl+,或Cmd+,）
2. 搜索git.scm.showSubmodulesAsChildren，勾选该选项
3. 点击源代码控制视图右上角的刷新按钮（或重启VS Code），子模块就会自动缩进显示在对应的父仓库下方，完全匹配你期望的层级结构：

Repo1
  SubmoduleXY
  ZubmoduleA
Repo2
  SubmoduleXY
  ZubmoduleA
Repo3
  SubmoduleXY
  ZubmoduleA

扩展增强方案 #

如果原生设置无法满足额外需求（比如需要更多子模块管理功能），可以尝试以下扩展：

• GitLens：这款热门Git增强扩展会自动优化子模块的显示层级，同时提供子模块的提交历史、差异对比等附加功能
• Submodule Manager：专门针对Git子模块的工具，不仅能清晰展示父子层级，还支持一键初始化、更新子模块等操作

手动配置（进阶） #

若需要更精细的控制，可直接编辑settings.json文件（快捷键Ctrl+Shift+P/Cmd+Shift+P，输入Open Settings (JSON)），添加以下配置：

{
  "git.scm.showSubmodulesAsChildren": true,
  "scm.repositories.sortOrder": "alphabetical" // 可选，按字母顺序排列仓库
}

注意事项 #

• 确保你的VS Code版本不低于1.70，旧版本没有原生的子模块嵌套显示功能
• 子模块必须已完成初始化和更新（执行过git submodule init和git submodule update），否则VS Code无法识别其与父仓库的关联

内容的提问来源于stack exchange，提问作者ゲオルギオス