MSBuild构建混合.NET Standard与.NET Framework解决方案遇阻求助

看起来你在混合解决方案的构建上踩了不少坑，我来帮你拆解下问题并给出可行的方案：

核心问题分析 #

Visual Studio能正常构建是因为它会自动处理解决方案级别的包还原，再按依赖顺序构建项目；但你的XAML构建定义要么单独构建.NET Standard项目时没做还原，要么把restore和build混在一起触发了.NET Framework项目的兼容性问题。你之前尝试在项目文件里硬编码restore目标，反而触发了MSBuild的依赖循环，这是因为Microsoft.NET.Sdk本身已经内置了restore的逻辑，手动叠加会打乱目标依赖链。

推荐解决方案1：分阶段构建（最稳妥） #

把构建流程拆成两个独立步骤，完全复刻Visual Studio的构建逻辑：

1. 第一步：解决方案级别的包还原
   在XAML构建定义中添加一个MSBuild任务，仅执行restore目标：

   msbuild YourSolution.sln /t:Restore
   

   这会为所有项目（包括.NET Framework和.NET Standard）生成必要的project.assets.json和依赖文件，不会触发任何项目的编译。

2. 第二步：正常构建/发布解决方案
   再添加一个MSBuild任务，执行build或publish目标：

   msbuild YourSolution.sln /t:Build
   # 或者如果需要发布.NET Standard项目
   msbuild YourProject.csproj /t:Publish
   

   此时所有依赖文件都已准备好，.NET Standard项目能正常编译，.NET Framework项目也不会受到restore目标的干扰。

推荐解决方案2：项目级条件化还原（如果必须在项目文件中处理） #

如果不想拆分构建步骤，可以在.NET Standard项目中添加条件性的restore触发逻辑，避免循环依赖和无效还原：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup Label="Globals">
    <SccProjectName>SAK</SccProjectName>
    <SccProvider>SAK</SccProvider>
    <SccAuxPath>SAK</SccAuxPath>
    <SccLocalPath>SAK</SccLocalPath>
  </PropertyGroup>
  <PropertyGroup>
    <RootNamespace>MyCompany.Common</RootNamespace>
    <TargetFramework>netstandard2.0</TargetFramework>
    <AssemblyName>MyCompany.CommonStandard</AssemblyName>
  </PropertyGroup>

  <!-- 仅当缺失project.assets.json时，才在编译前触发还原 -->
  <Target Name="ConditionedRestore" BeforeTargets="CoreCompile" Condition="!Exists('$(MSBuildProjectDirectory)/obj/project.assets.json')">
    <MSBuild Projects="$(MSBuildProjectFile)" Targets="Restore" />
  </Target>
</Project>

这个逻辑的核心是：只有当依赖文件确实缺失时，才会自动触发restore，既保证了编译的前提条件，又不会因为重复触发restore导致MSBuild目标循环。

为什么你之前的尝试失败了？ #

• InitialTargets="restore"：Microsoft.NET.Sdk的Restore目标本身依赖于项目初始化的内部目标，而InitialTargets会强制在所有目标之前执行，直接触发了_FilterRestoreGraphProjectInputItems的循环依赖。
• DefaultTargets="restore;build;publish"：把restore和build绑定为默认目标，会导致每次构建都强制先执行restore，但.NET Framework项目的构建逻辑不兼容这种强制顺序，且restore的执行时机和编译衔接不紧密，会出现类型未定义的错误（本质是依赖文件还没生成就开始编译）。
• BuildDependsOn添加Restore：直接将Restore加入构建依赖链，没有考虑restore本身的执行时机，导致编译开始时project.assets.json还未生成，触发缺失文件的错误。

额外建议 #

• 确保你的Visual Studio 2017升级到15.9及以上版本，早期版本对.NET Standard的MSBuild支持存在bug。
• 下游打包项目尽量单独执行publish目标，避免影响整个解决方案的构建流程。

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