MSBuild报错：无法从程序集加载Example自定义ITask任务该如何解决

• 解决依赖未复制的问题
  类库项目默认不会将NuGet引用的依赖包复制到输出目录，编译时只需要引用路径存在对应程序集即可通过，因此不会报错，但MSBuild加载任务时必须能探测到所有依赖。
  在自定义任务的Example.csproj中加入以下配置，强制复制所有依赖到输出目录：

  <PropertyGroup>
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
  </PropertyGroup>
  

  重新编译自定义任务项目后，检查输出目录是否已存在Microsoft.Build.Utilities.Core.dll等所有依赖文件。

• 匹配MSBuild运行时版本
  VS设计期使用的MSBuild运行时可能和你编译任务的运行时不兼容：

  1. VS 2019及更早版本的设计期MSBuild基于.NET Framework，无法直接加载.NET 5编译的程序集
  2. 建议将自定义任务的目标框架改为netstandard2.0保证兼容性，或者配置多目标编译：

  <PropertyGroup>
    <TargetFrameworks>net472;net5.0</TargetFrameworks>
  </PropertyGroup>
  

  调整后根据使用的MSBuild运行时选择对应版本的程序集填写到UsingTask的AssemblyFile属性中。

• 校验任务类声明合法性
  检查ZebusTask类的定义是否符合要求：

  • 必须为public修饰的非抽象类
  • 必须包含public无参构造函数
  • 必须实现Microsoft.Build.Framework.ITask接口，或继承自Microsoft.Build.Utilities.Task基类

• 修正项目编译顺序
  确认Main项目编译前，自定义任务项目已完成编译、输出目录下存在完整的dll文件。可以右键Main项目选择「生成依赖项」-「项目依赖项」，勾选自定义任务项目，强制保证编译顺序。

• 精准定位加载失败原因
  以上步骤都无法解决时，使用系统自带的程序集绑定日志查看器fuslogvw.exe开启绑定日志，重新触发设计时编译，即可直接查看具体加载失败的程序集名称、MSBuild尝试搜索的路径，快速定位问题。

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