使用dotnet pack生成NuGet包：仅在snupkg中包含所有pdb的问题

核心配置思路 #

问题出在手动指定Content打包DLL时，切断了NuGet对依赖PDB的符号包关联逻辑。需要分开配置：

• 让依赖DLL进入主Nupkg，但排除所有PDB
• 单独将依赖PDB添加到符号Snupkg中，不影响主包

完整CSPROJ配置 #

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <DebugType>portable</DebugType> <!-- 必须用portable格式，适配Snupkg要求 -->
  <IncludeSymbols>true</IncludeSymbols>
  <SymbolPackageFormat>snupkg</SymbolPackageFormat>
  <SuppressDependenciesWhenPacking>false</SuppressDependenciesWhenPacking>
</PropertyGroup>

<!-- 打包依赖DLL到主包的lib目录，明确排除PDB -->
<ItemGroup>
  <Content Include="..\host\bin\Release\net8.0\*.dll" Pack="true" PackagePath="lib\net8.0" />
  <!-- 禁止所有依赖PDB进入主Nupkg -->
  <Content Include="..\host\bin\Release\net8.0\*.pdb" Pack="false" />
</ItemGroup>

<!-- 专门将依赖PDB添加到符号Snupkg，不影响主包 -->
<ItemGroup>
  <SymbolPackageFile Include="..\host\bin\Release\net8.0\*.pdb" PackagePath="lib\net8.0" />
</ItemGroup>

配置说明 #

1. SymbolPackageFile项：这是NuGet专门用于向符号包（Snupkg）添加文件的配置，只会影响符号包，完全不会出现在主Nupkg中
2. Pack="false"：对PDB设置这个属性，仅排除它进入主包，不会阻止其他配置将其加入符号包
3. DebugType=portable：确保符号文件格式符合Snupkg的要求，避免符号包无法正常识别

验证步骤 #

1. 执行打包命令：dotnet pack -c Release
2. 解压生成的.nupkg文件，确认lib/net8.0目录下只有DLL，无PDB
3. 解压生成的.snupkg文件，确认lib/net8.0目录下包含主项目和所有依赖项的PDB

注意事项 #

• 确保依赖项的DLL和PDB是同一构建版本，路径正确
• ADO管道中需先完成所有依赖项目的构建，生成DLL和PDB后再执行Pack步骤
• 不要使用ExcludeFromPackage属性，它会同时将文件从主包和符号包中排除

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