切换出.NET Core 2.0迁移分支后构建失败求助

我之前也踩过类似的坑，结合你的场景给你梳理下问题根源和解决方案：

首先得明确：.NET Core 2.0已经完全弃用了project.json，改用csproj文件，所以报错里提到的project.json大概率不是你仓库里的文件，而是NuGet/MSBuild的缓存残留或者旧配置引用在搞鬼。迁移分支构建正常，是因为它的csproj配置符合.NET Core 2.0规范，而切换分支后本地残留的旧缓存干扰了新分支的构建流程。

先解决当前的构建失败问题（无需硬重置仓库） #

试试这些更高效的步骤，不用删仓库重置：

1. 清理NuGet本地缓存，彻底清除旧配置残留：

   dotnet nuget locals all --clear
   

2. 清理项目的中间构建文件和输出目录，避免旧文件干扰：
   • 手动删除项目根目录下的bin和obj文件夹，或者执行命令：

     dotnet clean
     

3. 重新执行NuGet还原，让工具链加载当前分支的正确配置：

   dotnet restore
   

4. 最后尝试重新构建：

   dotnet build
   

预防迁移分支合并后问题复发 #

你担心合并后问题重现，核心是要确保迁移分支的配置能和develop分支兼容，同时消除旧工具链的影响：

• 检查迁移分支的csproj文件，确保正确配置了RuntimeIdentifiers（替代旧project.json里的runtimes）。比如针对Windows平台，可以在csproj里添加：

  <PropertyGroup>
    <RuntimeIdentifiers>win-x64;win-x86</RuntimeIdentifiers>
  </PropertyGroup>
  

  这个配置告诉.NET Core SDK你要支持的运行时，和报错里要求的"runtimes": { "win": { } }作用一致，但这是.NET Core 2.0的正确写法。
• 合并前先在本地做测试：把迁移分支合并到本地develop，然后执行上面的清理+还原+构建步骤，确认没问题再推送到远程。
• 确保团队所有人都使用**.NET Core 2.0及以上版本的SDK**，旧版本的SDK可能还会保留对project.json的处理逻辑，导致奇怪的报错。
• 检查项目的.gitignore文件，确保bin、obj以及NuGet缓存相关的文件夹（比如.nuget）都被排除在版本控制外，避免切换分支时残留其他分支的构建文件。

为什么你的临时方案有效？ #

你用git reset --hard origin/develop解决问题，本质是强制覆盖了本地所有文件（包括残留的缓存和构建文件），让本地回到远程仓库的干净状态，所以构建恢复正常。但这只是治标不治本，清理缓存和规范配置才能彻底解决问题。

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