如何让NuGet包自动将文件复制到消费应用的输出目录？

我正在创建一个.NET Standard 2.0 NuGet包，用于统一.NET Framework和.NET Core应用中NLog的使用方式。我有一个作为所有应用标准模板的nlog.config文件，还有几个封装NLog、统一库交互方式的类。

我希望该NuGet包能将这个标准nlog.config文件部署到消费我的包的项目中，并将Copy To Output Directory设置为Copy Always或Preserve Newest。我知道这与.nuspec文件、build文件夹以及.props/.targets文件有关，但尝试多篇相关帖子后仍毫无头绪。我不知道该参考哪种方法，似乎有多种实现方式但都未生效。这是.NET Standard的问题吗？还是我操作有误？

我的.csproj文件相关部分：

<ItemGroup>
    <None Include="build\*.*" Pack="true" PackagePath="build">
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
</ItemGroup>

<ItemGroup>
    <Content Include="nlog.config" Pack="true" CopyToOutputDirectory="PreserveNewest">
        <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
</ItemGroup>

问题出在.NET Standard包的内容文件处理逻辑上：直接用Content项打包的文件，在消费项目中不会自动继承CopyToOutputDirectory属性，尤其是跨.NET Framework和.NET Core的场景，必须借助NuGet的build props/targets机制统一处理。

步骤1：调整项目结构 #

在你的NuGet项目根目录下新建build文件夹，然后创建一个和包名完全一致的.props文件（比如你的包叫MyTeam.NLog.Common，就命名为MyTeam.NLog.Common.props）。

步骤2：编写.props文件 #

在这个.props文件中添加逻辑，把nlog.config引入消费项目并设置复制属性：

<Project>
  <ItemGroup>
    <None Include="$(MSBuildThisFileDirectory)..\contentFiles\nlog.config" Link="nlog.config">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <Visible>false</Visible> <!-- 可选，避免在消费项目的解决方案资源管理器中显示该文件，如需让用户编辑可移除这行 -->
    </None>
  </ItemGroup>
</Project>

步骤3：修改.csproj配置 #

替换你原有的ItemGroup配置，改成以下正确的打包逻辑：

<!-- 将nlog.config打包到contentFiles目录，供props文件引用 -->
<ItemGroup>
  <Content Include="nlog.config" Pack="true">
    <PackagePath>contentFiles\any\any</PackagePath>
    <CopyToOutputDirectory>Never</CopyToOutputDirectory> <!-- 这里设为Never，复制逻辑交给props控制 -->
  </Content>
</ItemGroup>

<!-- 将build文件夹下的props文件打包到NuGet的build目录 -->
<ItemGroup>
  <None Include="build\*.props" Pack="true" PackagePath="build" />
</ItemGroup>

关键细节说明 #

1. 为什么不用直接Content打包？：.NET Standard包的Content项在.NET Core/.NET 5+项目中默认不会自动设置复制属性，而.NET Framework项目的处理逻辑也有差异，用props文件能统一两种框架的行为。
2. contentFiles目录的作用：这是NuGet官方推荐的跨框架内容文件分发目录结构，any\any表示适配所有目标框架和运行时。
3. Link属性：确保消费项目中的nlog.config显示在项目根目录（而非NuGet包的嵌套目录），方便用户直接修改模板内容。

验证步骤 #

1. 重新打包NuGet包：执行dotnet pack命令生成新的包文件。
2. 在测试项目中安装这个包，查看nlog.config的属性，确认Copy To Output Directory已设置为Preserve Newest。
3. 编译测试项目，检查输出目录是否包含nlog.config文件。

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