System.Reflection.Metadata.dll 的核心功能与缺失影响
.NET 元数据System.Reflection.Metadata.dll 是 .NET 平台中面向 ECMA-335 元数据、PE/COFF 文件和 Portable PDB 的低级基础程序集。它的设计目标不是替代传统反射，而是在不加载程序集执行上下文的前提下，直接读取、解析甚至构建程序集元数据。因此，编译器、构建系统、代码分析器、反编译工具和 IL 处理工具链经常依赖它。
核心功能
1. 元数据只读解析：MetadataReader 通过表结构和堆区读取程序集定义、模块、类型、方法、字段、属性、事件、泛型参数、自定义特性等；BlobReader 负责解码签名的二进制 Blob，SignatureDecoder 将类型签名转换为可理解结构。
2. 元数据写入与构建：MetadataBuilder、BlobBuilder、MethodBodyStreamEncoder 等类型支持创建程序集元数据、方法体、签名、自定义特性和调试信息，适合 IL 重写、程序集生成和编译器后端。
3. PE/COFF 与 CLI 结构访问：PEReader、PEHeaders、CorHeader、MetadataReaderProvider 可读取 PE 头、节表、CLI 头、元数据目录、入口点以及嵌入或外部元数据流。
4. Portable PDB 与调试符号：PortablePdbReader、PortablePdbBuilder 支持文档、序列点、局部变量、方法调试信息等符号数据的读取和生成，服务调试器、堆栈解析和诊断工具。
5. 方法体与 IL 分析：MethodBodyBlock、ILOpCode、异常处理区域等 API 可解析 IL 指令、局部变量签名和异常子句，用于静态分析、混淆检测、性能剖析和链接裁剪。
6. 高性能与低依赖：API 大量使用 Span<byte>、ImmutableArray<T> 和只读视图，适合在不反射执行代码的情况下进行快速元数据扫描，减少内存分配和加载副作用。
缺少 DLL 可能的影响
当应用程序、编译器插件或工具链声明依赖 System.Reflection.Metadata，但运行目录、共享框架、NuGet 缓存或发布输出中缺少匹配版本时，程序集加载会失败。典型异常包括 FileNotFoundException、FileLoadException、TypeLoadException、MissingMethodException 或绑定失败信息。
- 应用启动失败：依赖该程序集的主程序在入口阶段无法解析类型，直接崩溃或无法进入主流程。
- 构建与编译异常：Roslyn、MSBuild、NuGet、源生成器、分析器若无法加载该 DLL，可能出现编译错误、分析器崩溃、IDE 功能不可用。
- 工具链失效：反编译、IL 链接、AOT 裁剪、性能分析、程序集扫描、依赖检查等工具无法读取 PE 与元数据。
- 版本冲突：不同组件请求不同强名称版本，或共享框架版本与应用私有版本不一致，可能触发程序集绑定重定向失败。
- 发布部署问题：自包含发布、单文件发布、裁剪发布未包含该程序集时，运行时才发现缺失，导致环境相关故障。
修复与部署要点
优先通过 NuGet 引用与目标框架匹配的 System.Reflection.Metadata 包，确保复制本地或由共享框架提供；检查 deps.json、runtimeconfig.json、发布目录和绑定重定向。不要从不可信来源下载单个 DLL 覆盖系统目录，以免版本、强名称和签名不匹配。对于 .NET Core/.NET 5+ 应用，应确认目标运行时是否已包含所需版本，并在多插件环境中统一依赖版本。