在软件开发的世界里，我们经常会用到各种各样的第三方依赖，而 NuGet 就是.NET 生态系统中管理这些依赖的得力工具。今天咱就来聊聊 NuGet 符号包的发布，包括生成符号包、配置符号服务器以及如何利用这些来调试第三方依赖，让大家在开发过程中更加得心应手。

一、什么是 NuGet 符号包

NuGet 符号包其实就是包含了调试信息的特殊 NuGet 包。在我们开发的时候，如果引用了第三方的 NuGet 包，有时候出了问题想调试，普通的 NuGet 包可没办法让我们直接看到源代码和进行调试。而符号包就像是一把钥匙，能让我们深入到第三方包的内部去一探究竟。

应用场景

想象一下，你在做一个.NET 项目，引用了某个开源的 NuGet 包。在使用过程中，发现这个包好像有点小问题，你想看看它的源代码，找到问题所在。这时候，有了对应的符号包，你就能轻松地进行调试，就像在自己的代码里调试一样。

技术优缺点

优点嘛，首先就是方便调试。有了符号包，我们可以直接定位到第三方代码的问题，大大节省了排查问题的时间。而且，对于开源项目来说，符号包能让更多开发者参与到代码的调试和优化中。

缺点呢，符号包会增加包的大小，下载和安装的时间也会变长。而且，如果项目依赖的符号包太多，可能会占用比较多的磁盘空间。

注意事项

在使用符号包的时候，要注意版本的匹配。如果符号包的版本和你引用的 NuGet 包版本不一致，可能会导致调试信息不准确，甚至无法正常调试。

二、生成 NuGet 符号包

示例（DotNetCore 技术栈）

下面我们就来看看怎么生成 NuGet 符号包。假设你有一个简单的.NET Core 类库项目，项目结构如下：

MyLibrary
├── MyLibrary.csproj
└── Class1.cs

首先，打开 MyLibrary.csproj 文件，添加以下配置：

<!-- DotNetCore 技术栈示例 -->
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    <!-- 生成符号包 -->
    <IncludeSymbols>true</IncludeSymbols>
    <!-- 符号包的格式 -->
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
  </PropertyGroup>

</Project>

上面的配置中，IncludeSymbols 设置为 true 表示要生成符号包，SymbolPackageFormat 设置为 snupkg 是指定符号包的格式。

然后，在命令行中进入项目的根目录，执行以下命令来打包：

# 打包项目
dotnet pack -c Release

执行完这个命令后，在项目的 bin/Release 目录下，你会看到生成了两个包文件，一个是普通的 .nupkg 文件，另一个就是符号包 .snupkg 文件。

详细解释

dotnet pack 命令会根据项目的配置来生成 NuGet 包。-c Release 表示使用 Release 配置进行打包，一般在发布的时候我们都会使用 Release 配置。

注意事项

在生成符号包之前，要确保项目的代码是可以正常编译的。如果代码有错误，打包过程会失败，也就无法生成符号包。

三、配置符号服务器

有了符号包，还需要一个地方来存放它们，这就是符号服务器。符号服务器可以让 Visual Studio 等开发工具在调试的时候自动下载对应的符号包。

示例（使用本地符号服务器）

我们可以先搭建一个简单的本地符号服务器。创建一个文件夹，比如 C:\Symbols，把生成的 .snupkg 文件复制到这个文件夹里。

然后，打开 Visual Studio，依次点击 工具 -> 选项 -> 调试 -> 符号，在 符号文件(.pdb)位置 中添加本地符号服务器的路径 C:\Symbols。

详细解释

Visual Studio 会根据我们配置的符号服务器路径，在调试的时候去这些路径下查找对应的符号包。如果找到了，就会下载并使用其中的调试信息。

技术优缺点

优点是搭建本地符号服务器非常简单，不需要网络连接，调试速度可能会更快。缺点就是只能在本地使用，团队里的其他成员无法共享。

注意事项

要确保符号服务器的路径是正确的，并且有足够的权限访问。如果路径设置错误或者没有权限，Visual Studio 就无法找到符号包。

四、调试第三方依赖

现在符号包有了，符号服务器也配置好了，我们就可以开始调试第三方依赖了。

示例（DotNetCore 技术栈）

假设我们在另一个项目 MyApp 中引用了 MyLibrary 这个 NuGet 包。在 MyApp 项目的代码里调用 MyLibrary 中的方法：

// DotNetCore 技术栈示例
using System;
using MyLibrary;

namespace MyApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建 MyLibrary 中的类的实例
            var myClass = new Class1();
            // 调用方法
            var result = myClass.DoSomething();
            Console.WriteLine(result);
        }
    }
}

在调试的时候，当程序执行到调用 MyLibrary 方法的地方，Visual Studio 会自动去符号服务器查找对应的符号包。如果找到了，就可以单步调试 MyLibrary 中的代码了。

详细解释

当我们在调试时进入到第三方代码的方法中，Visual Studio 会根据符号包中的信息，找到对应的源代码文件，并加载到调试器中。这样我们就可以逐行执行代码，查看变量的值，找出问题所在。

注意事项

在调试第三方依赖之前，要确保项目引用的 NuGet 包版本和符号包的版本一致。如果不一致，可能会出现调试信息不准确的情况。

五、总结

通过生成 NuGet 符号包、配置符号服务器和调试第三方依赖，我们可以更方便地排查项目中第三方依赖的问题。生成符号包只需要在项目配置中简单设置一下，然后使用 dotnet pack 命令就可以了。配置符号服务器可以选择本地或者远程的，根据自己的需求来定。调试第三方依赖时，只要版本匹配，就能像调试自己的代码一样轻松。

不过，在使用过程中也要注意一些问题，比如符号包和 NuGet 包的版本匹配，符号服务器路径的正确性和权限等。希望大家通过这篇文章，能更好地利用 NuGet 符号包来提升开发效率。