使用git-tfs从TFS迁移到Git后出现编译元数据错误

1. 清理TFS绑定残留 #

迁移后项目可能还保留TFS的绑定信息，导致VS识别混乱：

• 打开解决方案，右键选择属性→源代码管理，确认当前绑定的是Git而非TFS，若不是则切换绑定。
• 手动删除项目中的.vssscc、.vspscc文件，同时打开.sln文件，删除GlobalSection(TeamFoundationVersionControl)相关的整个节点段。

2. 重新初始化Git仓库（绕开git-tfs的潜在问题） #

git-tfs生成的仓库可能带有TFS特定的元数据，建议重新构建Git仓库：

• 将迁移后的项目文件复制到新目录，删除原目录下的.git文件夹。
• 在新目录执行命令：

  git init
  # 添加标准Visual Studio .gitignore
  git add .gitignore
  git add .
  git commit -m "Initial commit from TFS migration"
  git remote add origin <你的Azure DevOps仓库URL>
  git push -u origin main
  

• 克隆这个新仓库到本地，验证是否还出现元数据错误。

3. 检查项目配置文件完整性 #

确认迁移过程中没有遗漏关键配置文件：

• 检查是否存在NuGet.Config文件，若本地有但Git仓库中没有，手动添加并提交。
• 打开.csproj/.vbproj文件，查找是否有指向TFS的路径或<SourceControlInformation>这类节点，删除后保存并提交。

4. 修复VS本地缓存问题 #

克隆后出现的错误可能是VS本地缓存导致：

• 在VS中右键解决方案→重新加载所有项目。
• 执行清理解决方案→重建解决方案，清除本地编译缓存。

5. 排查.gitignore规则 #

确认Azure DevOps仓库的.gitignore没有误排除必要文件：

• 检查.gitignore中是否有意外排除.csproj、.sln、.config这类核心项目文件的规则，若有则删除对应规则并重新提交推送。

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