本地克隆Git仓库后更新子模块失败，求解决方案

问题根源 #

你的本地模板仓库里，.gitmodules中子模块converter的URL用了相对路径../converter.git。当你克隆这个模板仓库时，Git会基于原模板仓库的本地路径来解析这个相对路径，导致新克隆仓库的.git/config里子模块URL变成了/template_path/converter.git——这个路径在新环境里根本不存在，自然克隆失败。

解决方案 #

方案1：修正.gitmodules的URL为绝对路径或远程仓库地址

这是最稳妥的办法，避免相对路径带来的解析问题：

1. 回到原模板仓库目录，执行命令更新子模块URL：

   git submodule set-url converter <子模块的远程仓库地址或本地绝对路径>
   

   比如子模块在本地/opt/repos/converter.git，就写：

   git submodule set-url converter /opt/repos/converter.git
   

2. 提交.gitmodules的修改：

   git add .gitmodules
   git commit -m "Fix converter submodule URL to use absolute/remote path"
   

3. 重新用Copier渲染模板，或者重新克隆仓库后执行git submodule update --init --recursive，就能正常拉取子模块了。

方案2：保持相对路径，但严格匹配目录结构

如果一定要用相对路径，确保克隆模板仓库的位置和原仓库的目录结构完全一致：

• 原仓库在/template_path/，子模块在/converter.git（和原仓库同级），那克隆模板时也要把新仓库放在和converter.git同级的目录下，比如/new_template_path/，这样../converter.git就能正确指向子模块仓库。

方案3：在Copier模板中添加钩子自动修正URL

如果模板需要适配不同环境，可以在Copier的copier.yml里添加生成后钩子，动态修正子模块URL：

post_gen_hooks:
  - git submodule set-url converter <你的子模块正确URL>

这样每次用Copier生成项目时，都会自动修正子模块的URL，避免路径解析错误。

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