运行MVC项目时无法加载SDK风格C#类库符号该如何解决？

修复方案 #

首先调整共享类库的csproj配置，针对不同目标框架单独设置调试类型，避免全局配置不兼容问题：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net472;netcoreapp3.1</TargetFrameworks>
  </PropertyGroup>

  <!-- .NET Framework 4.7.2 专用调试配置 -->
  <PropertyGroup Condition="'$(TargetFramework)' == 'net472'">
    <DebugType>full</DebugType>
    <DebugSymbols>true</DebugSymbols>
  </PropertyGroup>
  <!-- .NET Core 3.1 专用调试配置 -->
  <PropertyGroup Condition="'$(TargetFramework)' == 'netcoreapp3.1'">
    <DebugType>portable</DebugType>
    <DebugSymbols>true</DebugSymbols>
  </PropertyGroup>
</Project>

按以下步骤逐一排查剩余问题：

• 确认MVC项目对共享类库的引用为项目引用，而非直接引用bin目录dll或NuGet包。后两种引用方式无法关联源码，也会出现PDB不匹配问题。
• 关闭VS“仅启用我的代码”设置：打开工具 -> 选项 -> 调试 -> 常规，取消勾选“仅启用我的代码(仅限托管)”，保存后重启调试。
• 清理所有缓存文件：关闭VS，手动删除共享类库和MVC项目根目录下所有bin、obj文件夹，重新打开VS后先单独生成共享类库，再生成整个解决方案。
• 检查框架匹配：确认MVC项目输出目录下的共享类库dll对应net472版本，不要误引用netcoreapp3.1版本的dll，两个版本的PDB格式不兼容，会触发“找不到正确类型调试文件”的报错。
• 检查配置管理器：打开VS顶部菜单生成 -> 配置管理器，确认当前运行的配置（Debug/Release、CPU架构）下，共享类库的“生成”复选框已勾选，避免VS调用缓存的旧类库文件。
• 配置符号路径：打开工具 -> 选项 -> 调试 -> 符号，添加共享类库的net472输出目录到符号文件位置列表，调试时会自动搜索对应PDB。

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