如何配置NuGet包以避免安装时自动设置PrivateAssets为all

你的问题核心是NuGet包安装后自动生成的PackageReference包含了<PrivateAssets>all</PrivateAssets>和限制的<IncludeAssets>，导致编译时无法识别DLL引用。这是因为NuGet没有识别到包内的编译时资产，默认采用了私有资产配置。以下是具体解决方案：

1. 确保DLL放置在NuGet标准的lib目录 #

NuGet默认会将lib目录下的DLL识别为编译时引用，自动添加到项目的编译依赖中，不会生成多余的PrivateAssets配置。

在你的.nuspec文件中，通过<files>元素将DLL指定到对应框架的lib子目录：

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>MyPackage</id>
    <version>1.0.1</version>
    <authors>YourName</authors>
    <description>仅包含DLL的NuGet包</description>
  </metadata>
  <files>
    <!-- 针对.NET Framework 4.8的示例，替换为你的目标框架 -->
    <file src="bin/Release/MyLibrary.dll" target="lib/net48" />
    <!-- 如果支持多框架，添加对应目录 -->
    <file src="bin/Release/net6.0/MyLibrary.dll" target="lib/net6.0" />
  </files>
</package>

2. 显式添加MSBuild配置文件强制引用 #

如果因特殊需求无法使用lib目录，可以在包中添加.props文件，强制项目添加DLL引用，覆盖NuGet的默认资产配置。

步骤： #

1. 在包的源码目录创建build文件夹，新建MyPackage.props文件，内容如下：

<Project>
  <ItemGroup>
    <Reference Include="MyLibrary">
      <!-- 路径对应包内DLL的位置，这里假设DLL在lib/net48下 -->
      <HintPath>$(MSBuildThisFileDirectory)..\lib\net48\MyLibrary.dll</HintPath>
      <!-- 控制是否将DLL复制到输出目录，根据需求设置True/False -->
      <Private>True</Private>
    </Reference>
  </ItemGroup>
</Project>

2. 在.nuspec中包含这个.props文件：

<files>
  <file src="build/MyPackage.props" target="build" />
  <file src="bin/Release/MyLibrary.dll" target="lib/net48" />
</files>

3. 使用dotnet pack替代手动编辑nuspec（推荐） #

如果你用.NET SDK项目，可以直接在.csproj中配置打包规则，无需手动编写.nuspec，避免配置错误：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net48</TargetFramework>
    <PackageId>MyPackage</PackageId>
    <Version>1.0.1</Version>
    <Authors>YourName</Authors>
    <Description>仅包含DLL的NuGet包</Description>
  </PropertyGroup>
  <ItemGroup>
    <!-- 将DLL打包到lib目录 -->
    <None Include="path/to/MyLibrary.dll" Pack="true" PackagePath="lib/net48" />
  </ItemGroup>
</Project>

执行dotnet pack命令即可生成符合要求的NuGet包。

验证方法 #

生成包后，用NuGet Package Explorer打开包文件，确认：

• lib目录下存在对应框架的DLL
• 若使用.props文件，build目录下存在对应的配置文件

重新安装包后，项目文件的PackageReference将不再包含多余的PrivateAssets和IncludeAssets，DLL引用会被自动识别。

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