SDK风格项目迁移：InitialTargets中Zip任务找不到的解决咨询

核心原因 #

SDK风格项目的构建流程和传统项目不同，InitialTargets会在SDK默认导入逻辑之前执行。如果MSBuild.Community.Tasks.Targets的导入语句放在项目常规位置，会赶不上InitialTargets的执行时机，导致Zip任务无法被识别。

具体解决方案 #

方案1：在项目文件最顶部提前导入任务文件 #

把任务文件的导入语句放在<Project>标签之后、任何其他SDK导入或属性配置之前，确保InitialTargets执行前任务已加载：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 提前导入任务文件，路径替换为你的实际路径 -->
  <Import Project="$(NuGetPackageRoot)msbuild.community.tasks/1.10.0/build/MSBuild.Community.Tasks.Targets" />

  <PropertyGroup>
    <InitialTargets>TargetReadFiles</InitialTargets>
    <!-- 其他项目属性 -->
  </PropertyGroup>

  <Target Name="TargetReadFiles">
    <Zip SourceFiles="..." DestinationFile="..." />
  </Target>

  <!-- 其他项目内容 -->
</Project>

注：如果是本地文件而非NuGet包，直接写绝对路径或相对路径即可。

方案2：通过全局配置文件提前导入 #

如果有多个项目需要使用该任务，在解决方案根目录创建Directory.Build.props文件，全局导入任务文件，所有项目初始化时都会提前加载：

<Project>
  <Import Project="path/to/MSBuild.Community.Tasks.Targets" />
</Project>

方案3：调整目标执行时机（备选） #

如果不需要严格使用InitialTargets，可将目标改为在任务导入完成后的阶段执行，比如绑定到BeforeBuild：

<PropertyGroup>
  <!-- 移除InitialTargets配置 -->
</PropertyGroup>

<Target Name="TargetReadFiles" BeforeTargets="BeforeBuild">
  <Zip SourceFiles="..." DestinationFile="..." />
</Target>

关键提示 #

SDK项目中InitialTargets的执行优先级极高，必须保证任务文件的导入语句在InitialTargets定义之前执行，才能让Zip任务被识别。

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