添加本地仓库作为子模块却始终指向GitHub问题问询

核心原因拆解 #

• 仓库的远程关联残留：哪怕你删除了ProjectB的git remote配置，Git仓库的内部存储中仍可能保留着与原GitHub仓库的关联痕迹。比如仓库的commit对象在本地存储时会附带曾经关联的远程仓库引用，或是未被git gc清理的缓存记录，让Git识别出这个仓库原本属于GitHub。
• URL替换规则（insteadOf）：检查你的全局Git配置（~/.gitconfig）或ProjectA的本地配置（.git/config），如果存在url.<pattern>.insteadOf规则，Git会自动替换你输入的路径。比如配置了url.https://github.com/.insteadOf ../这类规则时，本地路径会被强制替换为GitHub URL。
• 子模块缓存未清理彻底：即便删除了.gitmodules和.git/config中的子模块配置，.git/modules目录下可能还有残留的缓存文件，这些文件会保留之前子模块的远程地址，导致Git复用旧配置。
• Git的可移植性设计：Git在处理子模块添加时，会优先尝试解析目标仓库的“官方”远程地址，而非直接使用你提供的本地路径——这是为了保证其他克隆ProjectA的用户，不会因为本地不存在对应路径而无法拉取子模块，属于Git的默认优先级逻辑。

验证与解决方法 #

• 检查全局替换规则：执行git config --global --list | grep insteadOf，查看是否存在会替换本地路径的规则
• 确认ProjectB的配置：打开ProjectB/.git/config，确保所有remote相关配置已完全删除
• 清理仓库缓存：在ProjectB目录执行git gc --prune=now，清理所有未引用的缓存对象
• 强制使用绝对路径：尝试用绝对路径添加子模块，比如git submodule add /full/path/to/ProjectB ProjectB

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