如何无需手动维护子模块，实现Git超项目及子模块的离线镜像

针对你提到的主仓库是裸仓库、无法直接运行git submodule update，且有大量子模块需要自动化处理的场景，这里给你一套完整的解决方案，完全不需要手动维护子模块：

一、首次创建离线镜像的步骤 #

1. 临时工作区初始化（在线环境执行） #

先在在线机器上创建一个临时工作目录，克隆主仓库的非裸版本（因为只有非裸仓库支持子模块相关命令）：

# 创建临时目录并克隆主仓库
mkdir temp-mirror-setup && cd temp-mirror-setup
git clone <你的主仓库在线URL> main-repo
cd main-repo

# 初始化并拉取所有子模块（无嵌套的话--recursive可以省略，但加上更通用）
git submodule update --init --recursive

2. 创建离线裸仓库结构（离线环境或可访问离线存储的位置执行） #

假设你的离线镜像目标路径是/offline-mirror，先创建主仓库的裸镜像，再批量创建所有子模块的裸镜像，保持和原项目一致的相对路径：

# 创建主仓库的裸镜像
git clone --bare . /offline-mirror/main-repo.git

# 批量创建所有子模块的裸镜像，路径对应原项目中的相对位置
git submodule foreach 'git clone --bare "$sm_path" "/offline-mirror/$sm_path.git"'

这里的$sm_path是子模块在主仓库中的相对路径（比如libs/utils），所以离线子模块的裸仓库会被放在/offline-mirror/libs/utils.git，和主仓库的相对关系完全匹配你已有的.gitmodules配置，无需额外修改路径。

二、后续更新离线镜像的步骤 #

当在线主仓库或子模块有更新时，重复以下步骤即可同步到离线镜像：

# 回到临时工作区的主仓库目录
cd temp-mirror-setup/main-repo

# 拉取主仓库的最新代码
git pull origin main

# 批量拉取所有子模块的最新代码（替换main为子模块的默认分支，如果不同的话）
git submodule foreach 'git pull origin main'

# 推送主仓库更新到离线镜像
git push /offline-mirror/main-repo.git --all
git push /offline-mirror/main-repo.git --tags

# 批量推送所有子模块的更新到离线镜像
git submodule foreach 'git push "/offline-mirror/$sm_path.git" --all'
git submodule foreach 'git push "/offline-mirror/$sm_path.git" --tags'

如果子模块使用不同的默认分支，可以用以下命令动态获取子模块配置的分支：

git submodule foreach 'git pull origin $(git config -f "$toplevel/.gitmodules" "submodule.$name.branch")'

三、使用离线镜像克隆项目 #

其他人需要从离线镜像克隆项目时，只需执行：

git clone --recursive /offline-mirror/main-repo.git my-local-project

Git会自动根据.gitmodules中的相对路径找到对应的离线子模块裸仓库，完成所有代码的克隆。

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