TFVC带历史迁移至Git的正确方法及Azure DevOps实操指引

工具选择对比 #

• git-tfs：老牌开源工具，能处理复杂的TFVC历史迁移，支持自定义规则，但需要手动敲命令，社区维护力度下降，对Azure DevOps新特性支持不足。适合技术能力较强、需要精细控制迁移细节的场景。
• git-tf：微软早期的轻量工具，功能有限，仅支持基础的克隆和提交，现已停止维护，不推荐用于大型或复杂仓库。
• Azure DevOps 官方迁移工具：当前最推荐的选项，集成在平台内无需额外安装，支持批量迁移、历史过滤（指定分支/文件夹），对大型仓库有性能优化，能自动处理冲突和权限映射，完全适配Azure DevOps生态。

大型TFVC仓库带历史迁移简化流程（Azure DevOps 官方工具） #

1. 前置准备
   • 确保你有TFVC仓库的读取权限，以及目标Git仓库的管理员权限。
   • 清理TFVC仓库：删掉冗余文件、废弃分支，减少迁移数据量；提前记好需要保留的分支、文件夹路径。
2. 创建目标Git仓库
   • 在Azure DevOps项目里新建Git仓库，名称和原TFVC仓库对应，不要勾选初始化README。
3. 启动导入向导
   • 进入目标Git仓库的「Repos」模块，点击右上角的「导入仓库」。
   • 源类型选「TFVC」，填写TFVC仓库的完整路径（比如$/项目名/仓库根路径）。
4. 配置迁移规则
   • 历史范围：可选「全部历史」或指定起始变更集；如果仓库特别大，建议分批次迁移（先迁最近的1000个变更集，再补充更早的）。
   • 路径过滤：只导入需要的文件夹/分支，排除构建输出、临时文件这类无用内容。
   • 分支映射：把TFVC的分支对应到Git分支（比如TFVC主分支映射到Git的main/master）。
5. 执行迁移
   • 点击「导入」开始迁移，平台会自动处理历史转换、冲突解决（有冲突时会提示手动干预）。
   • 大型仓库迁移耗时较长，建议在非工作时段执行。
6. 验证结果
   • 检查Git仓库的历史记录是否完整，文件结构和TFVC是否一致。
   • 克隆Git仓库到本地，确认文件内容无误。
   • 通知团队切换到新Git仓库，更新本地开发环境。

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