如何将本地已存在的Git仓库转换为Git子模块？

完全可以直接把已存在的本地目录转为子模块，不会覆盖现有内容，具体操作步骤如下：

1. 初始化父仓库
   进入/workspace目录，将其初始化为Git仓库：

   cd /workspace
   git init
   

2. 关联本地仓库为子模块
   对每个已有的本地仓库（比如repo1），用git submodule add命令指定本地路径作为仓库地址，Git会直接关联现有目录，不会重新克隆：

   # 添加repo1作为子模块
   git submodule add ./repo1 repo1
   # 添加repo2作为子模块
   git submodule add ./repo2 repo2
   

   第一个参数是本地仓库的相对路径（也可用绝对路径），第二个参数是子模块在父仓库中的目标路径（和现有目录同名即可）。执行后会自动生成.gitmodules文件，记录子模块配置信息。

3. 提交子模块配置
   将生成的配置文件和子模块引用提交到父仓库：

   git add .gitmodules repo1 repo2
   git commit -m "Add repo1 and repo2 as submodules"
   

4. 验证转换结果
   执行以下命令确认子模块已成功关联：

   git submodule status
   

   输出会显示每个子模块的提交哈希值、路径和分支信息，说明转换完成。

如果后续需要给子模块配置远程仓库，只需进入子模块目录添加远程地址即可：

cd repo1
git remote add origin <远程仓库URL>

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