使用相对路径与多远程仓库时如何指定子模块的远程仓库？

问题核心 #

你遇到的矛盾点很明确：.gitmodules中子模块的相对路径配置正确，但本地.git/config里的子模块远程地址却不对，最终导致拉取时出现仓库找不到或权限不足的错误。

原因拆解 #

Git在初始化子模块时，会基于**当前仓库的默认远程（通常是origin）**来解析相对路径。你的本地仓库同时配置了origin（你的fork）和main_repo（主仓库），如果子模块实际属于main_repo所在的仓库组，用origin的URL去解析../../path/submodule.git就会生成错误的远程地址——比如从git@example.com:myfork/fork.git解析出来的地址，和从git@example.com:some/path/main_repo.git解析的结果完全不同，自然拉取不到正确的子模块。

解决步骤 #

1. 直接修正本地子模块配置 #

手动修改.git/config里的子模块URL为正确地址：

[submodule "你的子模块本地路径"]
    url = git@example.com:some/path/submodule.git

2. 重新初始化子模块（适配多远程场景） #

如果不想手动改配置，可以先清除错误的子模块配置，再基于main_repo重新初始化：

# 移除已有子模块的本地配置
git submodule deinit -f 你的子模块本地路径
# 删除子模块的本地缓存文件
rm -rf .git/modules/你的子模块本地路径
# 基于main_repo的地址添加子模块（也可以用正确的相对路径）
git submodule add git@example.com:some/path/submodule.git 你的子模块本地路径
# 拉取子模块内容
git submodule update --init --recursive

3. 对齐CI与本地的解析逻辑 #

CI能正常工作是因为其环境里的仓库远程直接指向main_repo，相对路径解析正确。你本地可以通过以下方式对齐：

• 强制Git从.gitmodules的相对路径重新解析：

git submodule update --init --recursive --remote

• 把.git/config里的子模块URL改成相对路径（Git 1.8.2+支持）：

[submodule "你的子模块本地路径"]
    url = ../../path/submodule.git

这样Git每次拉取时都会基于当前仓库的远程地址动态解析，避免固定URL带来的偏差。

关键提醒 #

子模块的相对路径是基于远程仓库的URL结构解析，而非本地文件系统路径，这点很容易混淆。如果本地仓库有多个远程，初始化子模块时要明确以哪个远程作为解析基准。

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