GitHub迁移至Bitbucket：15-20个仓库迁移相关技术咨询

1. 是否有完整的迁移检查清单？ #

以下是针对多仓库迁移的实用检查清单，覆盖全流程：

前置准备 #

• 统计待迁移仓库核心信息：仓库大小、分支/标签数量、PR/Issue总量、Webhooks配置、权限层级
• 确认Bitbucket团队的存储空间配额，确保能容纳所有迁移仓库
• 规划迁移时间窗口，提前通知团队暂停代码提交，避免冲突
• 为每个GitHub仓库创建镜像备份：执行git clone --mirror <GitHub仓库地址>
• 清理仓库内的超大文件（Bitbucket单文件大小限制通常为1GB），或配置Git LFS处理

迁移执行 #

• 按优先级分批迁移（先迁非核心仓库做测试验证）
• 实时记录每个仓库的迁移状态（成功/失败/待重试）
• 迁移后立即验证代码完整性：对比分支、标签、提交哈希值

迁移后收尾 #

• 重新配置Bitbucket的Webhooks、Pipelines自动化流程
• 指导团队切换远程仓库地址：git remote set-url origin <Bitbucket仓库地址>
• 同步权限配置：确保团队成员、外部协作者的权限与GitHub一致
• 暂时保留原GitHub仓库为只读状态，避免误操作
• 收集团队反馈，快速处理迁移后的异常问题

2. 发现Bitbucket导入功能无法迁移PR、Issues，是否存在自动化迁移方案？ #

Bitbucket原生导入确实不支持PR和Issue迁移，可通过以下自动化方案解决：

• 自定义API脚本：基于GitHub REST API和Bitbucket Cloud API编写脚本，批量拉取GitHub的PR/Issue数据（含评论、状态、关联提交），转换为Bitbucket兼容格式后推送。常用Python、JavaScript实现，需注意两个平台的数据字段映射（比如GitHub的pull_request对应Bitbucket的pullrequest）
• 专业迁移工具：部分第三方迁移工具支持跨平台的PR/Issue同步，这类工具会自动处理格式转换和关联关系，可批量完成多仓库的迁移任务
• 关键注意点：迁移PR前需确保关联的提交已同步到Bitbucket，否则PR的代码对比会失效；迁移Issue时要保留原有的评论层级、标签、状态，避免信息丢失

3. Bitbucket导入功能还有哪些无法迁移的内容？ #

除PR和Issues外，原生导入功能通常无法迁移以下内容：

• 仓库级Webhooks、自定义钩子配置
• GitHub Actions工作流（需手动转换为Bitbucket Pipelines配置）
• Git LFS存储的大文件（需单独迁移或重新配置LFS）
• 精细分支权限（GitHub的分支级权限需在Bitbucket重新配置）
• 仓库的星级、Fork记录、Watch订阅
• PR/Issue中的附件、图片等媒体资源
• 提交记录的GPG签名验证信息

4. 迁移过程中可能遇到哪些已知问题？ #

迁移常见问题及注意点：

• 大仓库迁移中断：因网络波动或平台上传限制，大仓库易迁移失败，建议用镜像克隆后手动推送到Bitbucket
• 权限映射错误：若Bitbucket团队存在与GitHub同名用户，可能导致权限分配混乱，需提前核对成员账号
• 提交历史丢失：特殊提交（如空提交、复杂合并提交）可能无法被正确导入，迁移后需对比提交哈希值
• API调用受限：使用自定义脚本时，GitHub和Bitbucket的API均有调用频率限制，需添加请求延迟或使用官方API密钥提升限额
• 分支名称冲突：若目标Bitbucket仓库非空，可能出现分支名称冲突，迁移前需确保目标仓库为空
• 文件编码异常：非UTF-8编码的文件迁移后可能出现乱码，需提前检查仓库文件编码

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