本地部署TFS 2018迁移至GitHub遇阻，寻求技术帮助

一、修正git-tfs的URL格式 #

你之前使用的浏览器URL（http://:8080/tfs///_versionControl?path=%24%2FECHO%2F）不是git-tfs识别的有效路径，正确格式需拆分两部分：

• TFS集合基础URL：http://<TFS服务器IP>:8080/tfs/<集合名称>（默认集合通常为DefaultCollection，需根据你的TFS实例确认）
• 版本控制项目路径：$/ECHO（对应你示例中的项目路径）

二、离线环境部署git-tfs #

1. 在可联网机器上下载git-tfs稳定版二进制包、Git安装包
2. 将安装包拷贝到内部网络中能访问TFS的机器，完成安装

三、克隆TFS仓库到本地Git仓库 #

打开命令行，执行以下命令（替换占位符为实际信息）：

git tfs clone http://<TFS服务器IP>:8080/tfs/<集合名称> $/ECHO --branches=all

• --branches=all：迁移TFS所有分支，仅需主分支可省略该参数
• 若TFS需身份验证，可追加账号密码参数：

git tfs clone http://<TFS服务器IP>:8080/tfs/<集合名称> $/ECHO --branches=all --username="你的域账号" --password="你的密码"

• 历史提交过多导致克隆缓慢时，可先克隆历史再检出代码：

git tfs clone http://<TFS服务器IP>:8080/tfs/<集合名称> $/ECHO --no-checkout --branches=all
git checkout master

四、清理本地Git仓库（可选） #

移除TFS相关元数据，保证仓库纯净：

git tfs cleanup

五、同步到GitHub #

因TFS处于离线环境，需通过U盘、内部共享存储等介质将本地Git仓库拷贝到能访问GitHub的机器，再执行：

1. 添加GitHub远程仓库：

git remote add origin https://github.com/<你的GitHub用户名>/<目标仓库名>.git

2. 推送所有分支与提交历史：

git push origin --all
git push origin --tags

常见问题处理 #

• 若迁移大文件报错，先在本地Git仓库配置Git LFS追踪大文件，再推送至GitHub
• TFS分支结构复杂时，可先迁移主分支，再逐个迁移其他分支，降低出错概率

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