GitHub子模块内公共仓库SSH拉取失效问题咨询

结合你描述的所有可复现现象，能完全匹配“SSH子模块静默无反应、单独SSH克隆正常、换HTTPS地址子模块就正常工作”特征的核心原因，是本地全局Git的URL重写（insteadOf）规则存在错配。

具体原理 #

Git的insteadOf配置是无感知的URL自动替换逻辑，只要待处理的URL前缀和规则中定义的匹配串一致，就会直接把原URL替换成规则指定的目标地址，全程不会弹任何提示：

• 你之前配置的SSH形式子模块地址git@github.com:aws-quickstart/quickstart-microsoft-utilities.git，会被全局规则错误替换成一个无效应地址：如果替换后的地址被识别为本地文件路径，Git在执行子模块拉取时，会因为路径不存在而直接跳过操作——既不会发起网络请求，也不会抛出任何错误，完全对应你遇到的“无输出、无报错”的表现
• 你替换后的不完整HTTPS格式地址（https://aws-quickstart/quickstart-microsoft-utilities.git），因为URL前缀和错误重写规则的匹配范围不重合，没有触发错误替换，最终被正确解析为可访问的远程仓库地址，因此可以正常拉取
• 你在终端单独手动执行SSH克隆命令时，因为输入的完整地址没有落入错误重写规则的匹配范围，不会被替换成无效地址，所以可以正常连通、完成克隆。

验证方法 #

直接在操作时绕过全局重写规则测试即可定位问题：

1. 先查看当前全局配置里的所有URL重写规则，执行命令：
   git config --global --get-regexp 'url\..*\.insteadOf'
   重点看有没有规则的匹配前缀覆盖了git@github.com:aws-quickstart/这类子模块URL的开头
2. 临时禁用重写规则执行子模块初始化：
   git -c url.git@github.com:.insteadOf= submodule update --init
   如果执行后子模块能正常拉取，就可以100%确认是重写规则错配的问题。

低概率触发的其他场景 #

• 主仓库本地Git缓存目录（.git/modules/quickstart-microsoft-utilities）中已经存在子模块对应的目标commit，Git检测到本地版本和.gitmodules记录完全一致，就会无提示跳过拉取。这种情况删掉对应缓存目录后重新初始化即可验证。
• SSH连接在子模块的非交互执行环境下，因为没有绑定终端被host key二次确认阻塞，但这类场景一般会有隐藏的等待提示，结合你单独SSH克隆正常的现象，基本可以排除。

内容的提问来源于stack exchange，提问作者chum of chance