跨组织TFVC至TFVC（非Git）迁移：含历史、大仓库及无VS订阅实现方法

核心方案：使用TF命令行工具迁移完整历史 #

不需要Visual Studio订阅，也无需依赖VS Code，仅需Team Foundation Version Control (TF) 命令行工具即可完成，适合1GB以上的大仓库及多分支场景。

步骤1：准备目标环境 #

• 在目标Azure DevOps组织中创建对应项目，启用TFVC版本控制（创建项目时选择“TFVC”作为版本控制类型；若已创建项目，可在项目设置中添加TFVC仓库）
• 确保你在源仓库拥有读取权限，在目标仓库拥有完全控制权限

步骤2：安装TF命令行工具 #

• 访问源Azure DevOps组织的TFVC仓库页面，点击“克隆”按钮，选择“TF命令行”选项，按照页面提示下载并安装独立的TF工具包（无需Visual Studio订阅）

步骤3：配置源/目标工作区 #

1. 创建源工作区：

   tf workspace /new /collection:https://dev.azure.com/[源组织名称]/ /login:[源账号邮箱]
   tf workfold /map $/[源项目名称]/[TFVC仓库根路径] C:\Local\SourceTFVC
   

   拉取源仓库的完整内容及历史：

   tf get C:\Local\SourceTFVC /all /recursive /overwrite
   

   （大仓库可分分支拉取，比如先拉主分支$/[源项目]/Main，再单独处理其他分支）

2. 创建目标工作区：

   tf workspace /new /collection:https://dev.azure.com/[目标组织名称]/ /login:[目标账号邮箱]
   tf workfold /map $/[目标项目名称]/[TFVC仓库根路径] C:\Local\TargetTFVC
   

步骤4：迁移分支与完整历史 #

方法A：批量迁移（适合分支结构清晰的场景）

1. 切换到目标工作区目录：

   cd C:\Local\TargetTFVC
   

2. 将源工作区中对应分支的所有文件复制到目标工作区
3. 添加所有文件到目标仓库：

   tf add * /recursive
   

4. 提交初始迁移，备注清晰说明迁移来源：

   tf checkin /comment:"迁移源仓库[$/[源项目]/[源分支]]完整历史" /recursive
   

5. 重复上述步骤，逐个迁移所有分支

方法B：按变更集迁移（适合需要精准保留历史节点的场景）

1. 在源仓库中导出所有变更集列表：

   tf history C:\Local\SourceTFVC /recursive /format:detailed > SourceChangesets.txt
   

2. 逐个将源变更集的内容同步到目标仓库，需确保源与目标分支结构一致：

   tf merge /version:C[起始变更集编号]~C[结束变更集编号] C:\Local\SourceTFVC C:\Local\TargetTFVC /recursive
   tf checkin /comment:"迁移变更集C[编号]: [源变更集备注]" /recursive
   

步骤5：验证迁移结果 #

• 检查目标仓库的分支结构是否与源完全一致
• 核对变更集历史，确认所有历史记录完整保留
• 随机抽取不同历史版本的文件，验证内容与源仓库一致

大仓库优化建议 #

• 迁移前清理源仓库的冗余文件（如临时文件、构建产物），减少迁移体积
• 分批次迁移分支，避免单次操作过大导致超时
• 选择高速网络环境，或在靠近AzDO服务器的区域执行迁移操作

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