已启用Microsoft符号服务器，为何部分文件显示Decompiled/SourceLink/Metadata？

调试符号与源代码显示问题解答 #

1. 部分文件显示decompiled，部分显示SourceLink的差异原因 #

• 根源在于对应.NET库的发布配置不同：
  • 标注SourceLink的程序集（如Microsoft.AspNetCore.Mvc.ControllerBase），是微软发布时已嵌入SourceLink关联信息，调试器可通过符号服务器直接获取官方原始源代码，无需反编译。
  • 显示decompiled的程序集（如Microsoft.Extensions.DependencyInjection.JwtBearerExtensions），要么是发布时未配置SourceLink，要么是符号服务器上无对应原始源码文件。此时调试器会通过ICSharpCode.Decompiler这类工具从程序集中还原代码，因此会显示反编译标记。
  • 补充：微软并未给所有.NET库都配置SourceLink，部分旧版本库或特定组件可能暂未支持，就会触发反编译逻辑。

2. Microsoft.AspNetCore.Authentication.AuthenticationBuilder仅显示元数据的原因 #

• 核心是符号服务器缺少该类型对应的调试符号（.pdb文件）：
  • 调试器要展示源代码，必须先获取匹配的.pdb文件。如果该程序集的.pdb未上传到微软符号服务器，或者.pdb中没有关联源码的信息，调试器只能读取程序集的元数据（如类、方法的签名结构），无法显示实际代码。
  • 少数情况是该类型属于仅定义元数据的程序集（如仅包含接口、抽象类的库），但更常见的是符号缺失导致的。

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