使用MSBuild编译WPF用户控件遇多类异常，求解决方案

• 直接引用Microsoft.Build程序集引发System.BadImageFormatException：.NET 7默认是64位运行时，而你引用的Microsoft.Build程序集可能是32位版本，或者.NET Framework与.NET 7的MSBuild实现底层不兼容，跨框架直接引用必然导致程序集格式不匹配。
• 使用MSBuild NuGet包后的SDK相关错误：Microsoft.Build NuGet包是为构建工具自身设计的，并非给应用程序用来编译项目的依赖。它不包含完整的.NET SDK上下文（比如Microsoft.NET.Sdk、Workload相关props文件），这些文件是随系统安装的.NET SDK提供的，NuGet包里没有。
• MSBuild.Locator定位后的编译失败：
  • 重复导入目标文件：Locator同时加载了.NET Framework和.NET 7的MSBuild环境，两套目标文件规则冲突。
  • 找不到.NET Framework 4.0引用程序集：Locator默认指向.NET 7 SDK，未正确加载.NET Framework 4.7.2的引用程序集路径。
  • MarkupCompilePass1任务缺少Language参数：不同框架版本的MSBuild WPF编译任务参数定义有差异，.NET 7的MSBuild任务未获取到WPF项目的语言配置，或者参数传递逻辑不兼容。

• 精准使用MSBuild.Locator：
  • 只加载包含.NET Framework MSBuild的Visual Studio实例，筛选时排除纯.NET 7的SDK实例。示例代码：

    var validInstances = MSBuildLocator.QueryVisualStudioInstances()
        .Where(i => i.Version.Major >= 16 && i.IsBuildToolsInstalled);
    MSBuildLocator.RegisterInstance(validInstances.First());
    

• 编译时明确目标框架与SDK上下文：
  • 编译WPF项目时，通过MSBuildProjectCollection设置TargetFramework属性为net472，确保项目文件引用Microsoft.NET.Sdk.WindowsDesktop（推荐使用SDK风格的WPF项目格式）。
  • 手动指定ReferencePath属性，指向.NET Framework 4.7.2的引用程序集目录，路径通常为C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.7.2，解决系统程序集无法解析的问题。
• 杜绝跨框架混用MSBuild组件：
  • 不要在.NET 7项目中直接引用.NET Framework的Microsoft.Build程序集，所有编译操作都通过Locator加载的正确MSBuild实例执行，避免依赖冲突。
• 迁移WPF项目至SDK格式：
  • 若你的WPF用户控件项目是旧的非SDK格式，建议迁移为SDK风格项目，新格式与.NET 7的MSBuild环境兼容性更好，能减少目标文件导入错误。

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