跨组织Git仓库子模块相对URL配置错误求助

你遇到的问题是Git解析相对URL时未正确向上跳转目录层级，导致路径拼接错误。以下是正确的配置方法和原因说明：

正确的相对URL配置 #

在父仓库some-repo的.gitmodules文件中，子模块的URL应设置为：

[submodule "other-repo"]
    path = path/to/your/submodule
    url = ../other-org/other-repo.git

为什么你的配置没生效？ #

Git解析SSH格式的仓库URL时，会将冒号:后的部分视为服务器上的仓库路径。对于父仓库URL git@someserver.com:some-org/some-repo.git，Git会去掉最后一个路径组件（some-repo.git），得到基础路径some-org/，再拼接你设置的相对路径：

• 正确拼接逻辑：some-org/../other-org/other-repo.git → 最终解析为other-org/other-repo.git，对应完整URL git@someserver.com:other-org/other-repo.git

如果Git解析出错误路径git@someserver.com:some-org/other-org/other-repo.git，请检查以下两点：

• 确认父仓库的远程URL是否正确：执行git remote -v查看，确保输出包含git@someserver.com:some-org/some-repo.git
• 检查Git版本：Git 1.8.2及以上才支持完整的相对URL解析，旧版本可能存在解析逻辑问题，建议升级到最新稳定版

快速添加子模块的命令 #

直接在父仓库目录下执行以下命令，自动生成正确的.gitmodules配置：

git submodule add git@someserver.com:../other-org/other-repo.git path/to/your/submodule

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