为何Git克隆公开仓库无需密码，添加为子模块却要求输入？

核心原因 #

直接克隆公开仓库和拉取子模块时，Git的协议处理逻辑存在差异：

• 直接git clone公开仓库时，HTTPS链接会自动采用匿名访问模式，无需额外认证即可拉取。
• 拉取子模块时，Git会优先遵循全局或仓库级的url.insteadOf配置，如果你的配置中存在将HTTPS链接强制替换为SSH（比如url."git@github.com:".insteadOf "https://github.com/"），即便子模块是公开仓库，也会尝试用SSH协议拉取——若本地未配置SSH密钥（或密钥无对应权限），就会导致失败。
• 另外，如果主仓库是通过SSH协议克隆的，Git默认会继承主仓库的传输协议来拉取子模块，自动将子模块的HTTPS链接转为SSH，引发认证问题。

高效解决方案（无需逐个修改.gitmodules） #

1. 临时强制子模块用HTTPS拉取

执行以下命令，临时覆盖配置，强制子模块采用HTTPS协议：

git submodule update --init --recursive --config url."https://github.com/".insteadOf "git@github.com:"

（若使用其他代码托管平台，替换对应域名即可，比如GitLab改为https://gitlab.com/）

2. 全局/仓库级配置默认用HTTPS拉取子模块

如果经常遇到这类问题，可以配置Git优先用HTTPS处理子模块：

• 全局配置（所有仓库生效）：

  git config --global url."https://github.com/".insteadOf "git@github.com:"
  

• 单个仓库配置（仅当前主仓库生效）：
  进入主仓库目录后执行：

  git config url."https://github.com/".insteadOf "git@github.com:"
  

3. 移除冲突的全局配置

先检查当前是否存在干扰的url.insteadOf配置：

git config --global --get-regexp url

如果输出中有类似url.git@github.com:.insteadOf https://github.com/的条目，直接移除即可：

git config --global --unset url.git@github.com:.insteadOf

内容的提问来源于stack exchange，提问作者Hubert Bossy