跨Azure DevOps组织迁移TFVC至Git：git-tfs连接源TFVC仓库失败

地址格式硬伤 #

• 最初测试连接时使用的https://testpoint.visualstudio.com:8080/tfs/TestPoint2013存在本质格式错误：
  • 8080端口是本地部署TFS的默认服务端口，公有云Azure DevOps的TFVC服务走443端口的HTTPS通道，根本不开放8080端口的外部接入，因此报错直接卡在TCP连接超时阶段，根本还没走到身份校验环节，和凭证配置无关
  • 旧版*.visualstudio.com的域名现在已经重定向到新的dev.azure.com域名结构，原带端口的旧地址已经无法直接解析到正确的TFVC服务端点

SSH配置的认知误区 #

• 你当前配置的ssh.dev.azure.com主机名本身没有错误——这套配置确实可以正常连通同组织下的Git SSH仓库，但完全不适用于TFVC场景：
  • TFVC服务本身不支持SSH协议接入，SSH通道仅对Git仓库开放
  • git-tfs工具从设计上仅支持通过HTTPS SOAP接口连接TFVC服务，不会读取SSH配置文件，也不支持SSH传输通道，不管SSH密钥配置得多么正确，都没法通过SSH拉取TFVC内容

PAT认证的正确配置方式 #

在管理员关闭备选凭证的场景下，完全可以用PAT完成认证，之前连不上基本是格式用错了：

• 不要把PAT当成普通密码配账号，git-tfs对接Azure DevOps的PAT认证时，--username参数不需要填个人账号名，直接传任意非空字符串（比如access_token）即可，真正的认证凭据直接放在--password参数位置
• PAT的权限范围需要覆盖：代码（读写）、成员身份（读取），不要使用默认仅开放有限范围的PAT，不然会触发401权限拦截
• 正确的命令参考格式：

git tfs list-remote-branches https://dev.azure.com/你的组织名 $/项目名/TFVC目录路径 --username=access_token --password=你的PAT值

容易遗漏的检查项 #

• 先跳过工具，直接在浏览器打开对应https://dev.azure.com/你的组织名地址，确认当前账号能正常访问目标TFVC项目，排除网络代理、本地防火墙拦截443端口的问题
• 如果你实际要连接的是内部部署的TFS服务器（非公有云Azure DevOps），要提前确认当前网络能直接连通TFS服务器的IP和8080端口，且本地TFS本身不支持PAT认证，需要使用TFS后台配置的本地账号或Windows域账号完成连接，不要套公有云的PAT认证逻辑
• 确认本地安装的git-tfs为最新稳定版本，老旧版本不支持新Azure DevOps组织的PAT和MFA认证流程，即使参数配置正确也会触发连接报错

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