如何在After.Solution.sln.targets中正确使用NuGet MSBuild任务？

方案1：导入官方自带的Targets文件（推荐） #

这种方法利用NuGet自动生成的属性，无需手动注册任务，版本维护更简便：

1. 在解决方案根目录的Directory.Build.props中统一管理包版本和引用：

<Project>
  <PropertyGroup>
    <!-- 版本号集中维护，变更时只需修改这里 -->
    <MSBuildTasksVersion>1.5.0.235</MSBuildTasksVersion>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="MSBuildTasks" 
                      Version="$(MSBuildTasksVersion)" 
                      PrivateAssets="all" />
  </ItemGroup>
</Project>

2. 在After.Solution.sln.targets中直接导入包自带的Targets文件，自动注册所有任务：

<Project>
  <!-- 导入MSBuildTasks官方的Targets，自动注册Zip等任务 -->
  <Import Project="$(PkgMSBuildTasks)\build\MSBuild.Tasks.targets" 
          Condition="Exists('$(PkgMSBuildTasks)\build\MSBuild.Tasks.targets')" />

  <Target Name="RunZipTask" AfterTargets="YourBuildTarget">
    <!-- 直接使用Zip任务，无需额外配置 -->
    <Zip InputDirectory="$(YourSourceDir)"
         OutputFileName="$(YourOutputDir)\result.zip"
         IncludeEmptyDirectories="false" />
  </Target>
</Project>

• 细节：$(PkgMSBuildTasks)是NuGet自动生成的属性，对应包的安装路径，命名规则为$(Pkg<包名>)（包名首字母大写，其余保持原拼写）。
• 优势：版本集中管理，无硬编码路径，完全适配版本变更。

方案2：动态获取包路径注册任务（兼容特殊场景） #

如果导入官方Targets失败，可手动动态获取包路径并注册任务：

1. 同样在解决方案根目录的Directory.Build.props中定义版本和引用（同方案1）。
2. 在After.Solution.sln.targets中添加前置目标解析包路径，再注册任务：

<Project>
  <Target Name="ResolveMSBuildTasks" BeforeTargets="RunZipTask">
    <!-- 获取MSBuildTasks包的安装路径 -->
    <GetPackagePath PackageName="MSBuildTasks"
                    PackageVersion="$(MSBuildTasksVersion)"
                    OutputPath="$(NuGetPackageRoot)">
      <Output TaskParameter="PackagePath" PropertyName="MSBuildTasksPath" />
    </GetPackagePath>

    <!-- 动态注册Zip任务 -->
    <UsingTask TaskName="Zip"
               AssemblyFile="$(MSBuildTasksPath)\build\MSBuild.Tasks.dll" />
  </Target>

  <Target Name="RunZipTask" AfterTargets="YourBuildTarget">
    <Zip InputDirectory="$(YourSourceDir)"
         OutputFileName="$(YourOutputDir)\result.zip"
         IncludeEmptyDirectories="false" />
  </Target>
</Project>

• 细节：$(NuGetPackageRoot)是MSBuild 16+和NuGet 5+默认提供的属性，指向本地NuGet缓存目录；若环境特殊，可手动替换为你的缓存路径（如C:\Users\你的用户名\.nuget\packages\）。
• 优势：灵活性高，适用于官方Targets导入异常的场景，版本仍统一维护。

关键注意事项 #

• 确保Directory.Build.props位于解决方案根目录：只有这样，解决方案级的After.Solution.sln.targets才能访问到NuGet生成的属性和包路径。
• 添加PrivateAssets="all"：避免将MSBuildTasks作为依赖传递给其他项目，因为它仅用于构建过程，无需随项目发布。

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