Go代码仓库迁移至GitLab后，如何修复旧版本依赖的Git历史？

可以用git filter-repo工具批量重写Git历史里的依赖地址，不用逐个修改提交，步骤如下：

1. 先备份仓库
   因为修改历史是破坏性操作，先克隆镜像备份，防止出错：

   git clone --mirror <你的GitLab仓库地址> repo-backup.git
   

2. 克隆工作区仓库并进入

   git clone <你的GitLab仓库地址> repo-to-fix
   cd repo-to-fix
   

3. 批量替换依赖地址
   假设旧依赖地址前缀是bitbucket.org/your-team/，新地址是gitlab.com/your-team/，运行以下命令替换所有提交里go.mod和go.sum中的旧地址：

   git filter-repo --replace-text <(echo "bitbucket.org/your-team/ gitlab.com/your-team/")
   

   如果只想处理go.mod和go.sum，可以加上路径过滤：

   git filter-repo --path go.mod --path go.sum --replace-text <(echo "bitbucket.org/your-team/ gitlab.com/your-team/")
   

4. 强制推送到远程仓库
   处理完成后，强制推送覆盖远程历史（注意：这会改变所有提交的哈希值，团队成员需要重新克隆仓库，丢弃本地旧分支）：

   git push --force origin main
   

5. 处理依赖仓库
   对每个迁移的依赖仓库，重复上述步骤，替换自身地址引用，确保主仓库历史里的依赖路径也能对应上。

注意：git filter-repo是官方推荐替代git filter-branch的工具，需要Python 3.5+支持，如果没安装可以通过包管理器（比如brew、apt）或者pip安装。

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