Visual Studio发布.NET项目时NuGet包文件未复制的问题求助

核心原因 #

NuGet默认不会自动传递打包项目中设置的Copy to output directory属性——该属性属于项目本地构建配置，不会被打包到NuGet包的元数据中。而<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>仅对编译依赖的程序集生效，若你的DLL是作为内容文件而非编译引用，这个配置不会起作用。

解决方案 #

方案1：修改NuGet打包项目的csproj（推荐）

在打包项目的csproj文件中，为需要传递复制属性的DLL添加明确的打包元数据，确保安装到主项目时自动设置Copy always：

<ItemGroup>
  <!-- 替换为你的DLL实际路径 -->
  <Content Include="libs\*.dll">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    <!-- 标记文件需要复制到主项目输出目录 -->
    <PackageCopyToOutput>true</PackageCopyToOutput>
    <!-- 指定包内路径，兼容PackageReference格式 -->
    <PackagePath>contentFiles\any\any\;lib\net6.0</PackagePath>
  </Content>
</ItemGroup>

• PackageCopyToOutput：告诉NuGet在安装时将文件标记为需要复制到输出目录
• PackagePath：同时将DLL放到contentFiles和lib目录，兼容不同项目引用方式

方案2：通过nuspec文件配置（手动编写nuspec时）

如果是用nuspec文件打包，需要在<metadata>中声明contentFiles，并在<files>节点指定copyToOutput属性：

<package>
  <metadata>
    <!-- 其他元数据（如id、version等） -->
    <contentFiles>
      <files include="any/any/*.dll" buildAction="Content" copyToOutput="true" />
    </contentFiles>
  </metadata>
  <files>
    <!-- 替换为你的DLL源路径和目标路径 -->
    <file src="bin\Release\net6.0\*.dll" target="contentFiles/any/any" copyToOutput="true" />
  </files>
</package>

方案3：主项目中添加强制复制的Target（无需修改NuGet包）

如果无法修改NuGet包，可以在主项目的csproj中添加自定义Target，在构建和发布时强制复制这些DLL：

<Target Name="CopyCustomNuGetDlls" AfterTargets="Build">
  <!-- 替换为你的NuGet包ID、版本和目标框架 -->
  <Copy 
    SourceFiles="$(NuGetPackageRoot)/your-package-id/1.0.0/lib/net6.0/*.dll" 
    DestinationFolder="$(OutputPath)"
    SkipUnchangedFiles="true" />
</Target>

<Target Name="CopyCustomNuGetDllsPublish" AfterTargets="Publish">
  <Copy 
    SourceFiles="$(NuGetPackageRoot)/your-package-id/1.0.0/lib/net6.0/*.dll" 
    DestinationFolder="$(PublishDir)"
    SkipUnchangedFiles="true" />
</Target>

验证方法 #

重新打包NuGet包并安装到主项目后，查看主项目中这些DLL的属性，Copy to output directory应自动设为Copy always，发布时文件会自动包含在输出目录中。

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