Git仓库迁移至GitHub：如何为主仓库与子模块重新打标签？

方案一：批量打标签关联主仓库与子模块提交 #

这个思路完全可行——通过给主仓库中引用子模块旧提交的对应节点，和子模块重写后的新提交打上同名标签，来保留两者的历史关联。具体操作可以通过脚本自动化完成：

步骤1：生成子模块旧/新提交哈希映射 #

先在子模块仓库完成历史重写（比如用git filter-repo移除大文件），然后导出旧提交与新提交的对应关系：

# 在子模块仓库执行，导出旧引用与当前提交的映射
git for-each-ref refs/original/ --format='%(objectname) %(refname:short)' > submodule-old-new.txt
# 手动整理成每行“旧哈希 新哈希”的格式（或者用脚本匹配当前分支的提交对应关系）

步骤2：批量给子模块打标签 #

遍历映射文件，给子模块的新提交打标签：

while read old_hash new_hash; do
  tag_name="sub-sync-${old_hash:0:8}"
  git tag $tag_name $new_hash
done < submodule-old-new.txt
git push --tags  # 推送到Azure暂存，后续一起迁到GitHub

步骤3：遍历主仓库批量打标签 #

准备好所有引用该子模块的主仓库URL列表（比如main-repos.txt），执行脚本遍历每个主仓库：

while read repo_url; do
  repo_dir=$(basename $repo_url .git)
  git clone --mirror $repo_url $repo_dir
  cd $repo_dir

  # 提取所有涉及子模块引用变更的主仓库提交与对应的子模块旧哈希
  git log --all -p -- <子模块在主仓库中的路径> | grep -E '^commit |^-Subproject commit ' | awk '
    /^commit / {curr_commit=$2}
    /^-Subproject commit / {print curr_commit, $4}
  ' | while read main_commit old_sub_hash; do
    # 匹配子模块的新哈希，给主仓库提交打同名标签
    new_sub_hash=$(grep "^$old_sub_hash " ../submodule-old-new.txt | awk '{print $2}')
    if [ -n "$new_sub_hash" ]; then
      tag_name="sub-sync-${old_sub_hash:0:8}"
      git tag $tag_name $main_commit
    fi
  done

  git push --tags
  cd ..
done < main-repos.txt

方案二：补配LFS后直接迁移（无需重写历史） #

如果不想破坏子模块历史，最直接的方法是给子模块补配置Git LFS，把大文件转存到LFS后再推送：

1. 在子模块仓库初始化LFS：

   git lfs install
   git lfs track "<大文件的相对路径>"
   git add .gitattributes
   git commit -m "Add LFS tracking for large file"
   

2. 将子模块远程URL切换到GitHub，先推送LFS文件再推送分支：

   git remote set-url origin <GitHub子模块仓库URL>
   git lfs push --all origin
   git push --mirror origin
   

   注意：GitHub免费版LFS有存储和带宽限额，若超出需升级付费方案。

方案三：批量重写主仓库的子模块引用 #

如果已经重写了子模块历史，可以直接批量修改所有主仓库中的子模块引用，替换为新的哈希，彻底修复关联：

1. 准备好子模块的旧/新哈希映射文件submodule-old-new.txt
2. 遍历每个主仓库，用git filter-repo批量替换引用：

   git clone --mirror <Azure主仓库URL> main-repo-mirror
   cd main-repo-mirror
   # 生成替换规则并执行重写
   git filter-repo --replace-text <(while read old new; do
     echo "old:Subproject commit $old"
     echo "new:Subproject commit $new"
   done < ../submodule-old-new.txt)
   # 推送到GitHub
   git remote set-url origin <GitHub主仓库URL>
   git push --mirror origin
   

   注意：此操作会重写主仓库历史，需通知所有开发者切换到新仓库，旧仓库停止使用。

方案四：用GitHub导入工具自动处理 #

GitHub官方的仓库导入工具可以直接从Azure DevOps拉取仓库，并且自动检测大文件，提示启用LFS完成迁移：

1. 打开GitHub的仓库导入页面，输入Azure DevOps仓库的URL
2. 导入过程中勾选“Enable Git LFS”选项，工具会自动将大文件迁移到GitHub LFS，同时保留所有历史和子模块关联。

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