拥有符号与源码时，如何调试Blazor WebAssembly引用的私有NuGet包？

可以实现步进调试，只要正确配置符号文件与源码关联，以下是具体操作步骤：

• 确保NuGet包包含符号文件
  打包共享代码时，必须将pdb符号文件纳入包内，两种常用方式：

  • 生成独立符号包：在项目csproj中添加配置

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

    打包后会生成.symbols.nupkg或.snupkg符号包，将其与主NuGet包一同上传至私有NuGet服务器（需确保服务器支持符号包托管，如NuGet.Server、ProGet等）。
  • 将pdb嵌入主NuGet包：在csproj中添加配置

    <AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
    

    这样pdb会和dll一同放在包的lib目录下。

• 配置Visual Studio符号加载路径
  打开Visual Studio的「工具」→「选项」→「调试」→「符号」：

  • 点击「添加」，将私有NuGet服务器地址添加为符号源（如http://your-private-nuget-server/v3/index.json）；
  • 勾选「在符号加载时警告」，便于排查符号加载失败的问题；
  • 可设置本地符号缓存目录，避免重复下载。

• 关联源码（实现源码步进）
  若要调试时看到NuGet包的源码，可选择以下方式：

  • 嵌入源码到符号文件：在csproj中添加

    <EmbedAllSources>true</EmbedAllSources>
    

    打包后源码会嵌入pdb，调试时直接从pdb加载源码。
  • 配置Source Link：在csproj中添加Source Link配置，指向你的私有源码仓库（如GitLab、私有GitHub仓库），调试时会自动拉取对应版本的源码。

• Blazor WebAssembly调试特殊配置

  • 检查项目launchSettings.json，确保Blazor WASM配置包含调试入口：

    "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}"
    

  • Visual Studio中，右键项目→「属性」→「调试」，勾选「启用JavaScript调试（Blazor WebAssembly）」；
  • Chrome调试时（Shift+Alt+D），打开Sources面板的「Overrides」，添加本地源码目录，将NuGet包对应的源码路径映射到本地，确保调试时加载本地源码。

• 验证调试流程
  启动调试后，在业务代码中调用NuGet包方法并设置断点，执行到该方法时按F11步进：

  • 若符号未加载，打开「调试」→「窗口」→「模块」，找到对应NuGet包的dll，右键选择「加载符号」，手动指定符号文件路径或私有服务器源；
  • 符号加载成功后，即可步进进入NuGet包代码，若已关联源码，会自动显示对应源码文件。

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