dbgshim.dll：.NET 调试链路上的垫片中枢
在使用 Visual Studio 附加进程、VS Code 调试 C# 应用，或执行 dotnet-dump、dotnet-trace 等诊断命令时，调试器背后往往有一个体积极小却不可替代的原生模块在默默工作，它就是 dbgshim.dll。该文件随 .NET Runtime 与 .NET SDK 一同分发，常见路径为 C:\Program Files\dotnet\shared\Microsoft.NETCore.App\<版本>\dbgshim.dll 或 SDK 对应目录。
一、模块定位
shim 在软件工程中意为垫片，指在两个互不兼容的接口之间做转换的中间层。dbgshim.dll 正扮演这样的角色：它本身并不实现断点、单步、表达式求值等调试语义，而是负责把外部调试器与 CLR 内部的调试服务（由 mscordbi.dll 提供的 ICorDebug 体系）连接起来，是整个 CLR 调试链路的引导入口。
二、核心功能
1. 调试接口的创建与引导。该模块导出的 CreateDebuggingInterfaceFromVersion 等函数，允许调试器仅凭目标运行时的版本字符串获取一个可用的 ICorDebug 实例。dbgshim 据此解析出对应版本的调试组件路径，加载 mscordbi.dll 并转发调用。
2. 版本解耦与兼容。调试工具与目标进程所运行的 .NET 版本未必一致。dbgshim 承担版本协商与适配职责，使新版调试器能够调试旧版运行时，也让同机多版本运行时并存（side-by-side）时互不干扰。
3. 目标发现与附加。提供 CLR 实例枚举、运行时目录查询、进程托管性判断等能力，帮助调试器在 Attach 阶段准确识别目标运行时。
4. 转储与事后调试。在 dotnet-dump analyze、WinDbg 加载 SOS 扩展等场景下，负责从转储文件或目标进程中引导出调试接口。
5. 加载策略管理。在 Windows 上还涉及 DLL 搜索顺序、API Set 解析与 side-by-side 加载路径选择。
三、缺失后可能出现的影响
调试会话无法建立：Visual Studio 附加进程提示无法启动调试，VS Code 报出 Failed to load dbgshim.dll 或 Could not find dbgshim.dll。
诊断命令失效：dotnet-dump、dotnet-trace、dotnet-gcdump 等需要 CLR 调试接口的工具会中断或直接报错。
SOS 与转储分析不可用：WinDbg 中 .loadby sos coreclr 失败，崩溃转储无法解析托管堆栈。
仅影响调试与诊断链路：应用本身的启动、运行与业务逻辑通常不受影响，因为该模块只在调试器主动加载时才被引用。
四、常见的缺失成因
运行时被部分卸载或修复不完整、安全软件误删、精简版或绿色版运行时缺少组件、DOTNET_ROOT 与 PATH 指向不完整目录、SDK 与 Runtime 版本错配，以及在手工清理 dotnet 目录时误删该文件。