如何将Git仓库A的C模块转为单仓库并设为子模块，保留分支与提交历史？

下面是具体操作步骤，确保完成后使用git clone --recursive能正常获取作为子模块的C：

1. 提取模块C为独立Git仓库 #

首先从仓库A中分离出模块C的完整提交历史，创建独立新仓库：

• 克隆仓库A的镜像版本（包含所有分支和标签）：

  git clone --mirror https://gitlab..../A.git A-mirror
  cd A-mirror
  

• 使用git filter-repo过滤出仅属于模块C的提交和文件（若未安装该工具，可通过pip install git-filter-repo安装）：

  git filter-repo --path modules/C/ --path-rename modules/C/:./
  

  这条命令会保留所有涉及modules/C/目录的提交，并将C目录下的文件移动到新仓库的根目录。
• 在GitLab上创建空仓库（命名为C），将提取后的仓库推送到新地址：

  git remote set-url origin https://gitlab..../C.git
  git push --all
  git push --tags
  

• 清理临时镜像目录：

  cd .. && rm -rf A-mirror
  

2. 在仓库A的所有分支中替换C为子模块 #

修改仓库A的每个分支，移除原C目录并添加子模块：

• 克隆仓库A的普通版本：

  git clone https://gitlab..../A.git A-modified
  cd A-modified
  

• 遍历所有需要保留的分支（假设分支为main、dev、feature-x），逐个处理：

  for branch in main dev feature-x; do
    git checkout $branch
    # 删除原C目录并提交
    git rm -r modules/C/
    git commit -m "Remove module C directory to replace with submodule"
    # 添加C作为子模块，指定跟踪当前分支（与E、F保持一致）
    git submodule add -b $branch https://gitlab..../C.git modules/C
    git commit -m "Add module C as submodule tracking $branch branch"
    # 推送修改到远程分支
    git push origin $branch
  done
  

3. 验证子模块配置（可选） #

检查仓库A根目录的.gitmodules文件，确保C的配置与E、F格式一致，示例如下：

[submodule "modules/C"]
  path = modules/C
  url = https://gitlab..../C.git
  branch = main

若有修改，提交并推送该文件：

git add .gitmodules
git commit -m "Standardize submodule config for C"
git push origin main

4. 测试克隆效果 #

使用原命令克隆项目，验证子模块是否正常拉取：

git clone --recursive https://gitlab..../A.git test-clone
cd test-clone
# 查看所有子模块状态
git submodule status

输出中应包含C、E、F三个子模块的提交哈希，说明操作成功。

注意事项 #

• 所有团队成员需要重新克隆仓库，或在现有本地仓库执行git pull后运行git submodule update --init --recursive来同步子模块。
• 若仓库A存在其他未列举的分支，需重复步骤2的处理流程，确保所有分支完成替换。
• git filter-repo是官方推荐的历史修改工具，相比已弃用的git filter-branch更安全高效。

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