VS2022 + .NET 6 WebAPI发布NuGet时出现NU5129错误，本地无法复现

问题背景 #

使用VS2022 + .NET 6.0 ASP.NET WebAPI项目，修改项目文件后执行NuGet发布时触发构建错误：

NuGet.Build.Tasks.Pack.targets(221,5): error NU5129: - At least one .targets file was found in 'build/', but 'build/Company.Base.Core.targets' was not.

本地无法复现该问题，项目中对目标文件的配置如下：

<Content Include="Company.Base.Core.targets">
  <BuildAction>Content</BuildAction>
  <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  <PackagePath>build\</PackagePath>
  <IncludeInPackage>true</IncludeInPackage>
  <CopyToOutput>true</CopyToOutput>
</Content>

删除该.targets文件后，构建过程会自动重新生成它。

可能的解决方法 #

1. 修正路径分隔符 #

NuGet跨环境打包时对路径分隔符的处理存在差异，将配置中的PackagePath>build\</PackagePath>改为正斜杠格式：

<PackagePath>build/</PackagePath>

避免Windows与Linux构建环境下的路径解析不一致问题。

2. 明确指定打包的完整路径 #

直接指定文件在NuGet包中的完整路径，消除路径匹配的模糊性：

<Content Include="Company.Base.Core.targets">
  <BuildAction>Content</BuildAction>
  <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  <PackagePath>build/Company.Base.Core.targets</PackagePath>
  <IncludeInPackage>true</IncludeInPackage>
  <CopyToOutput>true</CopyToOutput>
</Content>

3. 调整自动生成文件的时机 #

由于.targets文件会自动重新生成，需确保生成动作在NuGet打包任务之前执行。在项目文件中添加目标顺序控制：

<Target Name="EnsureTargetsFileReady" BeforeTargets="GenerateNuspec">
  <!-- 若生成逻辑为自定义脚本，在此处调用脚本生成文件 -->
</Target>

保证打包启动前，目标文件已存在于正确位置。

4. 清理构建缓存 #

远程构建环境可能残留旧缓存导致路径匹配异常，打包前执行清理操作：

dotnet clean

或在CI/CD流水线中配置构建前清理工作目录，避免缓存干扰。

5. 检查条件性配置 #

排查项目文件中是否存在针对不同构建环境的条件性排除配置，比如确认Release模式下未意外移除该文件：

<!-- 检查是否存在类似的错误配置 -->
<Content Remove="Company.Base.Core.targets" Condition="'$(Configuration)' == 'Release'" />

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