截断Git仓库历史并从Azure DevOps迁移至GitHub的最佳方案

核心工具选择 #

使用git filter-repo替代老旧的filter-branch，它是Git官方推荐的历史重写工具，速度更快、更稳定，能高效处理大仓库的历史截断和文件清理。

操作步骤 #

1. 准备镜像仓库 #

先克隆原Azure DevOps仓库的镜像副本（避免直接修改原仓库）：

git clone --mirror <Azure DevOps仓库URL>
cd <仓库名>.git

2. 截断历史到指定日期 #

将<YYYY-MM-DD>替换为你的截止日期，执行命令跳过该日期前的所有提交：

git filter-repo --commit-callback 'if commit.committed_date < git_filter_repo.str_to_epoch("<YYYY-MM-DD>"): commit.skip()'

该命令会自动清理截止日期前提交中的二进制文件、大文件，因为这些历史已被彻底移除。

3. 保留指定分支 #

删除不需要保留的分支，假设需要保留main和feature/v2分支：

git for-each-ref --format="%(refname:short)" refs/heads | grep -vE "^main$|^feature/v2$" | xargs git branch -D

4. 清理无效标签并保留有效标签 #

截断历史后，部分标签可能指向已被删除的提交，执行以下命令清理无效标签，保留关联到现有提交的标签：

git for-each-ref --format="%(refname:short) %(objectname)" refs/tags | while read tag hash; do
  if git rev-parse --verify "$hash" >/dev/null 2>&1; then
    echo "保留标签: $tag"
  else
    git tag -d "$tag"
  fi
done

5. 彻底清理垃圾数据 #

执行垃圾回收，彻底移除所有被截断的历史数据：

git gc --prune=now --aggressive

6. 推送到GitHub远程仓库 #

添加GitHub仓库地址并推送所有保留的分支和标签：

git remote add github <GitHub仓库URL>
git push github --all && git push github --tags

关键注意事项 #

• 所有提交ID会因历史重写改变，这是不可避免的，需通知团队成员切换到新的GitHub仓库。
• 若截止日期后的提交仍包含大文件，可额外执行git filter-repo --strip-blobs-bigger-than 100M（将100M替换为你的阈值）清理大文件。
• 操作全程在镜像仓库进行，避免破坏原Azure DevOps仓库的数据。

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