如何将NuGet包中的DLL复制到消费项目子文件夹且不覆盖原有文件？

• 创建包含程序集的NuGet包，将该程序集复制到消费项目的输出子文件夹（默认NuGet会把lib目录下的DLL复制到输出基础目录）
• 示例：输出目录为bin\x64\Debug时，目标路径是bin\x64\Debug\someSubfolder
• 核心要求：不得修改输出基础目录中的其他DLL（需保留其他包带来的旧版本some.framework.dll）
• 适配所有构建配置与平台（Debug/Release、AnyCPU/x64/x86等）

已尝试方案及问题 #

方案1：通过props文件复制，但覆盖基础目录旧DLL #

nuspec配置：

<files>
    <file src="some.props" target="build" />
    <file src="bin\AnyCPU\Debug\net8.0\some.framework.dll" target="lib\net8.0" />
</files>

配套props文件：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <someAssembly Include="$(NuGetPackageRoot)\myPackage\$(PackageVersion)\lib\net8.0\some.framework.dll" />
  </ItemGroup>

  <Target Name="CopyAssembly" AfterTargets="Build">
    <Copy SourceFiles="@(someAssembly)" DestinationFolder="$(OutputPath)\someSubfolder" />
  </Target>
</Project>

问题：DLL成功复制到子文件夹，但由于将DLL放在lib目录，NuGet会自动将其复制到输出基础目录，覆盖了其他包带来的旧版本some.framework.dll。

方案2：用contentFile打包，构建报错 #

将DLL作为contentFile打包，打包成功但消费项目构建时出现错误。

解决方法 #

核心思路：不要将目标DLL放入lib目录（避免NuGet自动复制到输出基础目录），而是将DLL打包到NuGet的contentFiles或build\assets目录，再通过MSBuild目标手动复制到指定子文件夹。

步骤1：修改nuspec配置 #

将DLL从lib移到contentFiles目录（或build\assets目录），同时保留props文件：

方式1：使用contentFiles目录

<files>
    <file src="some.props" target="build" />
    <!-- 按框架/平台分目录，适配多版本场景 -->
    <file src="bin\AnyCPU\Debug\net8.0\some.framework.dll" target="contentFiles\any\net8.0\someSubfolder" />
</files>

方式2：使用build/assets目录

<files>
    <file src="some.props" target="build" />
    <file src="bin\AnyCPU\Debug\net8.0\some.framework.dll" target="build\assets\net8.0" />
</files>

步骤2：修改props文件，安全复制DLL到子文件夹 #

通过MSBuild从NuGet包的安装路径复制DLL，同时禁止NuGet自动处理该文件：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 定位NuGet包中的目标DLL -->
  <ItemGroup>
    <!-- 如果用contentFiles方式 -->
    <SomeFrameworkAssembly Include="$(MSBuildThisFileDirectory)..\contentFiles\any\$(TargetFramework)\someSubfolder\some.framework.dll" />
    <!-- 如果用build/assets方式，替换为：
    <SomeFrameworkAssembly Include="$(MSBuildThisFileDirectory)assets\$(TargetFramework)\some.framework.dll" />
    -->
  </ItemGroup>

  <!-- 在构建完成后复制到输出子文件夹 -->
  <Target Name="CopyCustomAssemblyToSubfolder" AfterTargets="AfterBuild">
    <Copy 
        SourceFiles="@(SomeFrameworkAssembly)" 
        DestinationFolder="$(OutputPath)someSubfolder"
        SkipUnchangedFiles="true" />
  </Target>

  <!-- 关键：禁止NuGet自动将该DLL复制到输出基础目录 -->
  <ItemGroup>
    <Content Remove="@(SomeFrameworkAssembly)" />
    <None Include="@(SomeFrameworkAssembly)" Pack="false" />
  </ItemGroup>
</Project>

补充说明 #

• 为什么不放在lib：lib目录下的DLL会被NuGet视为程序集依赖，自动复制到输出基础目录，且会触发版本冲突覆盖，这正是我们要避免的。
• 多框架适配：如果需要支持多个.NET版本（如net6.0、net8.0），只需在nuspec中按框架分目录，props中用$(TargetFramework)动态匹配即可。
• 平台适配：如果需要区分x64/x86平台，可以在nuspec的target路径中加入平台标识（如contentFiles\x64\net8.0\someSubfolder），props中用$(PlatformTarget)动态匹配。

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