Bitbucket迁移至GitLab：如何验证代码仓库的Tags、Commit History等完整性？

一、单仓库验证步骤 #

本地准备 #

先把源（Bitbucket）和目标（GitLab）仓库都克隆到本地同一目录：

git clone <Bitbucket仓库地址> repo-source
git clone <GitLab仓库地址> repo-target

1. 分支完整性验证 #

• 查看所有分支（含远程），对比数量和名称：

  # 源仓库
  cd repo-source
  git branch -a
  
  # 目标仓库
  cd ../repo-target
  git branch -a
  

• 批量对比分支HEAD哈希，确保每个分支的最新提交一致：

  # 源仓库导出分支哈希映射
  cd repo-source
  git for-each-ref --format="%(refname:short) %(objectname)" refs/heads/ > source-branches.txt
  
  # 目标仓库导出并对比差异
  cd ../repo-target
  git for-each-ref --format="%(refname:short) %(objectname)" refs/heads/ > target-branches.txt
  diff source-branches.txt target-branches.txt
  

2. 提交历史验证 #

• 对比总提交数，快速判断是否有提交丢失：

  # 源仓库提交总数
  cd repo-source
  git rev-list --count HEAD
  
  # 目标仓库提交总数
  cd ../repo-target
  git rev-list --count HEAD
  

• 导出完整提交哈希列表，逐行对比确保哈希链完全一致：

  cd repo-source
  git log --format="%H" > source-commits.txt
  
  cd ../repo-target
  git log --format="%H" > target-commits.txt
  diff source-commits.txt target-commits.txt
  

• 关键分支可单独查看提交历史的简洁输出，直观对比：

  git log --oneline <分支名>  # 分别在两个仓库执行
  

3. Tags 完整性验证 #

• 查看所有Tags及绑定的哈希值，对比名称、数量、哈希：

  # 源仓库
  cd repo-source
  git tag -l -n --format="%(refname:short) %(objectname)"
  
  # 目标仓库
  cd ../repo-target
  git tag -l -n --format="%(refname:short) %(objectname)"
  

• 批量导出对比，避免手动遗漏：

  cd repo-source
  git tag -l --format="%(refname:short) %(objectname)" > source-tags.txt
  
  cd ../repo-target
  git tag -l --format="%(refname:short) %(objectname)" > target-tags.txt
  diff source-tags.txt target-tags.txt
  

4. 仓库结构与文件内容验证 #

• 对比文件目录结构，确保没有文件/目录缺失：

  # 源仓库导出目录结构（排除.git目录）
  cd repo-source
  find . -type f -name "*.git" -prune -o -print | sort > source-files.txt
  
  # 目标仓库导出并对比
  cd ../repo-target
  find . -type f -name "*.git" -prune -o -print | sort > target-files.txt
  diff source-files.txt target-files.txt
  

• 若需验证文件内容无篡改，批量计算文件哈希值对比：

  # 源仓库生成所有文件的SHA256哈希清单
  cd repo-source
  find . -type f -name "*.git" -prune -o -exec sha256sum {} \; | sort > source-hashes.txt
  
  # 目标仓库生成并对比
  cd ../repo-target
  find . -type f -name "*.git" -prune -o -exec sha256sum {} \; | sort > target-hashes.txt
  diff source-hashes.txt target-hashes.txt
  

二、100+仓库批量验证方案 #

手动逐个验证效率太低，写个Shell脚本批量处理更高效：

1. 先准备一个仓库清单文件repo-list.txt，每行格式为：Bitbucket仓库URL GitLab仓库URL
2. 用以下脚本自动完成克隆、验证、生成报告：

#!/bin/bash
while read source_url target_url; do
  repo_name=$(basename "$source_url" .git)
  echo "=== 正在验证仓库: $repo_name ==="
  
  # 临时克隆仓库（--depth 1 加快速度，若需完整提交历史则去掉）
  git clone --depth 1 "$source_url" temp-source
  git clone --depth 1 "$target_url" temp-target
  
  # 分支验证
  git -C temp-source for-each-ref --format="%(refname:short) %(objectname)" refs/heads/ > source-branches.txt
  git -C temp-target for-each-ref --format="%(refname:short) %(objectname)" refs/heads/ > target-branches.txt
  if diff source-branches.txt target-branches.txt > /dev/null; then
    echo "✅ 分支验证通过"
  else
    echo "❌ 分支验证失败，差异文件: ${repo_name}-branch-diff.txt"
    diff source-branches.txt target-branches.txt > "${repo_name}-branch-diff.txt"
  fi
  
  # Tags验证
  git -C temp-source tag -l --format="%(refname:short) %(objectname)" > source-tags.txt
  git -C temp-target tag -l --format="%(refname:short) %(objectname)" > target-tags.txt
  if diff source-tags.txt target-tags.txt > /dev/null; then
    echo "✅ Tags验证通过"
  else
    echo "❌ Tags验证失败，差异文件: ${repo_name}-tag-diff.txt"
    diff source-tags.txt target-tags.txt > "${repo_name}-tag-diff.txt"
  fi
  
  # 清理临时文件
  rm -rf temp-source temp-target source-*.txt target-*.txt
  echo "-------------------------"
done < repo-list.txt

提示：如果要完整验证提交历史，去掉git clone后的--depth 1参数，但克隆10年历史的仓库会耗时较长，可根据实际需求调整。

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