在 NuGet 提供符号 NuGet 库的支持，在默认上传将会同时上传符号库。在 NuGet 上传文件将会默认将 snupkg 符号文件上传

让 NuGet 发布默认不上传符号文件的方法是添加参数 NoSymbols 请看代码

 nuget push .\bin\release\*.nupkg -Source https://api.nuget.org/v3/index.json -SkipDuplicate -NoSymbols

在 nuget 发布可以给某个文件路径，将这个路径所有文件上传，在上传文件时，将会同步上传符号文件。如果符号文件不存在，建议输出提示

File does not exist (.\bin\release\*.snupkg)

通过在命令行添加参数不上传外，还可以在创建 NuGet 库创建符号文件，这样就不会提示找不到

在 sdk style 格式的项目文件，添加下面代码，添加之后打包就会创建 snupkg 文件

<PropertyGroup>
    <IncludeSymbols>true</IncludeSymbols>	
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>	
</PropertyGroup>

这里的 PropertyGroup 元素可以添加到 Project 元素下

另一个方法是在命令行打包添加参数

dotnet pack -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg

如果使用 msbuild 打包，可以使用下面代码

msbuild /t:pack /p:IncludeSymbols=true /p:SymbolPackageFormat=snupkg

如果使用 nuget 打包，如对应的 xx.nuspec 可以使用下面代码

nuget pack MyPackage.nuspec -Symbols -SymbolPackageFormat snupkg

NuGet 符号服务器

How to publish NuGet symbol packages using the new symbol package format ‘.snupkg’

在 NuGet 包嵌入 符号文件 的方法是添加 AllowedOutputExtensionsInPackageBuildOutputFolder 属性

<Project Sdk="Microsoft.NET.Sdk">
 <PropertyGroup>
    <!-- Include symbol files (*.pdb) in the built .nupkg -->
    <AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
  </PropertyGroup>
</Project>

默认符号文件是放在 snupkg 文件，而不是放在 nupkg 文件，原因是将符号文件放在 nupkg 文件，会让 nupkg 文件太大。如果将符号文件放在 nupkg 文件，那么不需要开发者另外配置符号服务器，就可以拿到符号文件

详细请看 Roslyn 打包自定义的文件到 NuGet 包

本文会经常更新，请阅读原文： https://dotnet-campus.github.io//post/NuGet-%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%B8%8A%E4%BC%A0%E6%89%BE%E4%B8%8D%E5%88%B0-snupkg-%E6%96%87%E4%BB%B6.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 lindexi （包含链接： https://dotnet-campus.github.io/ ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 。

相关文章