如何将TFVC 2008中含历史记录的所有内容迁移到Git并最终同步至GitHub

前置准备 #

• 准备Windows系统设备，TFS2008适配工具对Windows兼容性更好，需提前安装*.NET Framework 3.5*及以上版本，确保设备可以正常访问TFS 2008服务器
• 在GitHub账号中创建空的目标仓库，不要初始化README、.gitignore、开源许可证等默认文件
• 安装Git客户端，提前配置好GitHub账号的全局用户名、邮箱，以及访问凭据（SSH密钥或个人访问令牌）确保可以正常推送代码到GitHub
• 安装git-tfs工具，该工具专门适配TFS到Git的迁移场景，支持TFS2008版本，解压后将工具所在路径添加到系统环境变量PATH即可使用

迁移操作步骤 #

步骤1：验证TFS连接可用性 #

打开命令提示符，执行以下命令验证连接，替换占位符为你自己的实际信息，执行后按提示输入TFS登录凭据，确认可以正常列出TFS端的所有分支：
git tfs list-remote-branches http://你的TFS服务器地址:8080/tfs/你的团队项目集合名

步骤2：拉取TFS全量内容和完整历史到本地 #

执行克隆命令，拉取项目所有分支、标签和完整提交历史到本地：
git tfs clone http://你的TFS服务器地址:8080/tfs/你的团队项目集合名 $/TFS上的项目根路径 本地存储文件夹名 --branches=all
如果项目历史体量过大，也可以指定起始变更集拉取，追加参数--changeset=起始变更集ID即可。

提示：如果你的TFS2008分支结构不是标准树状结构，可按照命令行提示手动补充分支映射参数，适配你的项目结构。

步骤3：关联本地仓库到GitHub远程端 #

进入刚才拉取生成的本地项目文件夹，执行命令添加GitHub远程仓库地址：
git remote add github https://github.com/你的GitHub用户名/目标仓库名.git

步骤4：推送全量内容到GitHub #

先推送所有分支内容：
git push github --all
再推送所有标签内容：
git push github --tags

迁移后校验 #

• 登录GitHub查看目标仓库的提交历史，确认所有提交记录、分支、标签都完整同步
• 随机抽查几个历史版本的代码内容，确认和TFS端对应变更集的内容完全一致
• 如有需要可以批量修改提交信息，补充TFS工作项ID的关联标记，满足溯源需求

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