如何将包含子模块的Git仓库整合为单个对象提交至本地Git仓库？

你不需要把文件压缩成ZIP包，Git本身就有两种原生方法可以帮你把主仓库和子模块的内容合并成单一仓库，完全符合你的需求。下面分两种场景给你详细步骤：

方法一：直接合并内容（简单快捷，适合不需要保留子模块独立历史的情况） #

如果子模块的历史对你来说不重要，只想把所有文件整合到一个仓库里，用这个方法最省事：

1. 准备本地文件：确保你已经拿到主仓库和子模块的完整文件目录（比如从GitHub下载源码包解压，或者通过其他合规方式获取）。
2. 清理子模块关联：
   • 删除主仓库根目录下的 .gitmodules 文件（如果存在）
   • 打开主仓库的 .git/config 文件，删掉所有和子模块相关的配置条目
   • 删除主仓库 .git/modules 目录下对应的子模块文件夹（这是Git存储子模块元数据的地方）
3. 整合文件：把子模块的所有文件移动到主仓库中原来子模块所在的目录（比如原来子模块在 ./submodule-dir，就把文件放到这个目录下）
4. 提交并推送：

   git add .
   git commit -m "Integrate submodule content into main repository"
   git push <你的公司内网仓库地址> <分支名>
   

方法二：使用git subtree（保留子模块历史，适合需要追踪子模块变更的情况） #

如果你需要保留子模块原来的提交历史，方便后续对比原GitHub仓库的更新，git subtree 是更合适的选择：

1. 添加子模块远程源：假设你已经通过某种方式获取到子模块的Git仓库（比如下载了裸仓库），先在主仓库里添加这个源：

   git remote add submodule-origin <子模块的本地路径或原GitHub地址>
   

2. 合并子模块内容到指定目录：

   git subtree add --prefix=submodule-dir submodule-origin main
   

   这里的 submodule-dir 是你想要存放子模块内容的目录，main 是子模块的默认分支（根据实际情况调整）。
3. 提交并推送：

   git commit -m "Add submodule via git subtree"
   git push <你的公司内网仓库地址> <分支名>
   

   后续如果能访问原GitHub子模块仓库，还可以用 git subtree pull --prefix=submodule-dir submodule-origin main 来更新子模块内容。

两种方法对比 #

• 方法一：操作简单，没有额外的Git配置，但子模块的独立历史会丢失，后续无法直接从原仓库更新。
• 方法二：保留子模块的完整历史，支持后续更新，但操作稍复杂，需要能获取到子模块的Git仓库数据。

不管选哪种，都不需要用ZIP包压缩，完全是Git原生的解决方案，能满足你把所有内容放到单一仓库并推送到内网服务器的需求。

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