如何配置ASP.NET Core项目自动复制NuGet包的.pdb文件至输出目录？

嗨，这个问题我之前折腾过好一阵，手动复制pdb文件确实太繁琐了，其实有几个靠谱的配置方式能让系统自动把NuGet包对应的.pdb文件同步到输出目录，给你整理一下：

方法1：全局配置自动复制所有NuGet包的pdb文件 #

直接在你的ASP.NET Core项目的.csproj文件里添加以下配置块，就能自动抓取所有已安装NuGet包的.pdb文件并复制到输出目录：

<PropertyGroup>
  <!-- 确保所有依赖的程序集都被复制到输出目录 -->
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

<ItemGroup>
  <!-- 匹配NuGet缓存目录下所有的.pdb文件，设置为复制到输出 -->
  <Content Include="$(UserProfile)\.nuget\packages\**\*.pdb">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <Visible>false</Visible>
  </Content>
</ItemGroup>

这里CopyLocalLockFileAssemblies是确保所有依赖的dll都被复制，而Content项会递归匹配NuGet缓存目录里的所有.pdb文件，PreserveNewest只会复制更新过的文件，避免每次构建都重复操作，Visible设为false是为了不在项目文件列表里显示这些外部文件，保持整洁。

方法2：只复制特定NuGet包的pdb文件 #

如果你不需要所有包的pdb，只想针对某些特定包配置，比如只复制Newtonsoft.Json的pdb，可以改成更精准的路径匹配：

<ItemGroup>
  <Content Include="$(UserProfile)\.nuget\packages\newtonsoft.json\**\*.pdb">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <Visible>false</Visible>
  </Content>
</ItemGroup>

只需要把路径里的包名换成你需要的即可。

方法3：Debug模式下的优化配置（推荐开发环境） #

在Debug模式下，其实还有一种方式：你可以让调试器直接找到pdb文件，不一定非要复制到输出目录。不过如果确实需要复制的话，配合下面的配置能让符号文件更完整：

<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
  <DebugType>full</DebugType>
  <DebugSymbols>true</DebugSymbols>
</PropertyGroup>

这会确保项目自身的符号文件是完整的，再结合前面的复制规则，就能拿到所有需要的pdb文件了。

注意事项 #

• 以上配置只适用于PackageReference格式的NuGet引用（现在ASP.NET Core项目默认都是这种），如果是旧的packages.config格式，路径需要调整，但现在基本没人用这个了。
• 如果你使用的是Linux或macOS，把$(UserProfile)换成$(Home)即可，路径会自动适配系统。

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