Git仓库迁移与历史清理实战指南

作为开发团队协作的核心工具，Git仓库的迁移和历史清理是每个开发者都需要掌握的重要技能。本文将深入讲解如何安全高效地进行仓库迁移和敏感数据清理。

一、仓库迁移的两种核心方式

1. 修改远程地址（适合已有本地仓库）

当远程仓库地址变更时（如从GitHub迁移到GitLab），只需修改本地配置：

# 查看当前远程仓库
git remote -v

# 修改远程仓库URL
git remote set-url origin https://new-repo-url.git

# 验证修改
git remote -v

实践建议：

使用git remote rename origin old-origin先重命名旧远程，再添加新远程，可保留备份
迁移后首次推送建议使用git push --all origin和git push --tags确保完整迁移

2. 使用git bundle离线打包（适合无网络环境）

当需要在隔离网络环境中迁移仓库时：

# 在源机器打包全部历史
git bundle create repo.bundle --all

# 将bundle文件复制到目标机器
scp repo.bundle user@new-machine:/path

# 在目标机器克隆
git clone repo.bundle new-repo -b master

高级用法：

# 仅打包特定分支
git bundle create partial.bundle master feature-branch

# 增量打包（基于上次打包的提交）
git bundle create incremental.bundle last-commit..HEAD

二、清理仓库历史中的敏感数据

1. 使用git filter-branch（原生方案）

# 删除包含敏感信息的文件
git filter-branch --force --index-filter \
  'git rm --cached --ignore-unmatch secrets.txt' \
  --prune-empty --tag-name-filter cat -- --all

# 清理本地引用
rm -rf .git/refs/original/
git reflog expire --expire=now --all
git gc --prune=now

注意事项：

操作会重写所有提交的SHA值，影响所有协作者
对大仓库性能较差（可以考虑使用filter-repo替代）

2. 使用BFG Repo-Cleaner（更高效）

首先安装BFG：

brew install bfg  # macOS
# 或下载jar文件
wget https://repo1.maven.org/maven2/com/madgag/bfg/1.14.0/bfg-1.14.0.jar

清理示例：

# 删除特定文件
java -jar bfg.jar --delete-files secrets.txt

# 替换敏感文本（如密码）
java -jar bfg.jar --replace-text passwords.txt

# 后续清理
git reflog expire --expire=now --all
git gc --prune=now --aggressive

BFG优势：

比filter-branch快10-100倍
默认不处理未保护的提交（保护最新提交）

三、最佳实践与注意事项

迁移前检查清单：
- 确保所有分支已推送：git branch -avv
- 验证标签完整性：git tag -l
- 检查子模块状态：git submodule status
历史清理警告：

必须通知所有协作者重新克隆仓库
考虑保留旧仓库为归档状态

仓库瘦身技巧：

# 查找大文件
git rev-list --objects --all | \
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
  awk '/^blob/ {print substr($0,6)}' | \
  sort --numeric-sort --key=2 | \
  cut -c 1-12,41- | \
  $(command -v gnumfmt || echo numfmt) --field=2 --to=iec-i --suffix=B --padding=7 --round=nearest

自动化迁移脚本示例：

#!/bin/bash
# 迁移脚本示例
OLD_REPO=$1
NEW_REPO=$2

git clone --mirror $OLD_REPO temp-repo
cd temp-repo
git remote set-url origin $NEW_REPO
git push --mirror
cd ..
rm -rf temp-repo

四、总结

Git仓库迁移和清理是高级但必要的技能，关键点在于：

小仓库优先使用remote set-url，大仓库考虑bundle
历史清理首选BFG工具，其次考虑filter-branch
所有历史重写操作都需要团队协作
迁移后务必验证分支、标签和提交历史的完整性

掌握这些技巧后，你将能够自如地管理代码仓库的生命周期，确保代码历史既安全又整洁。

Git仓库迁移与历史清理完整指南