如何为包含第三方程序集的.NET Standard 2.0类库创建NuGet包

方法一：修改项目文件（.csproj）直接配置打包 #

这种方式无需额外工具，直接通过编辑项目文件实现第三方DLL的打包：

1. 在你的.NET Standard 2.0类库项目中，新建libs文件夹存放第三方DLL，右键选择添加 -> 现有项将DLL导入项目。
2. 选中导入的DLL，在属性面板设置：
   • 生成操作：Content
   • 复制到输出目录：如果较新则复制
3. 右键项目选择编辑项目文件，添加以下配置（替换占位符为实际信息）：

   <ItemGroup>
     <!-- 引用本地第三方DLL -->
     <Reference Include="Xceed.TargetAssembly">
       <HintPath>libs\Xceed.TargetAssembly.dll</HintPath>
       <Private>True</Private>
     </Reference>
     <!-- 配置打包时将DLL放入NuGet包的对应框架目录 -->
     <None Include="libs\Xceed.TargetAssembly.dll" Pack="true" PackagePath="lib/netstandard2.0" />
   </ItemGroup>
   

4. 重新生成项目后，通过项目属性的“包”选项生成NuGet包，第三方DLL会被包含在包的lib/netstandard2.0目录下，其他项目安装后即可直接引用命名空间。

方法二：使用.nuspec文件手动打包 #

如果项目文件配置无法满足需求，可手动创建.nuspec文件进行精细控制：

1. 在项目目录下打开命令提示符，执行命令生成基础.nuspec文件：

   nuget spec
   

2. 编辑生成的.nuspec文件，添加第三方DLL的包含规则，示例配置如下：

   <?xml version="1.0"?>
   <package >
     <metadata>
       <id>Your.Team.PackageId</id>
       <version>1.0.0</version>
       <title>封装Xceed组件的类库包</title>
       <authors>Your Team</authors>
       <requireLicenseAcceptance>false</requireLicenseAcceptance>
       <description>团队内部使用，包含自定义类库及Xceed专属.NET Standard组件</description>
       <dependencies>
         <group targetFramework=".NETStandard2.0" />
       </dependencies>
     </metadata>
     <files>
       <!-- 包含自身类库的编译输出 -->
       <file src="bin\Release\netstandard2.0\Your.Library.dll" target="lib/netstandard2.0" />
       <file src="bin\Release\netstandard2.0\Your.Library.pdb" target="lib/netstandard2.0" />
       <!-- 包含第三方Xceed组件 -->
       <file src="libs\Xceed.TargetAssembly.dll" target="lib/netstandard2.0" />
       <file src="libs\Xceed.TargetAssembly.pdb" target="lib/netstandard2.0" /> <!-- 如有调试文件建议包含 -->
     </files>
   </package>
   

3. 在项目目录下执行打包命令（需确保nuget.exe已加入环境变量）：

   nuget pack YourProject.csproj -Properties Configuration=Release
   

4. 生成的NuGet包会包含所有指定文件，其他项目安装后可正常引用命名空间。

关键注意事项 #

• 确认第三方DLL为**.NET Standard 2.0兼容版本**，否则可能出现运行时兼容性错误。
• 如果第三方DLL存在依赖组件，需一并打包到NuGet包中，避免出现缺失依赖的问题。
• 测试安装包时，建议清理NuGet缓存（VS菜单：工具 -> NuGet包管理器 -> 管理解决方案的NuGet包 -> 设置 -> 清除所有NuGet缓存），避免旧包干扰。

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