二进制序列化在.NET中有很多使用场景，如我们使用分布式缓存时，通常将缓存对象序列化为二进制数据进行缓存，在ASP.NET中，很多中间件（如认证等）也都是用了二进制序列化。
在.NET中我们通常使用System.Runtime.Serialization.Formatters库中的BinaryFormatter来进行二进制序列化，但此库存在以下缺点：
- 尽管.net core对BinaryFormatter进行了一些列优化，但其性能还是较低
- 序列化结果尺寸过大，BinaryFormatter保留了非常详细的类型元数据。
- 安全问题，BinaryFormatter 因为其强大的功能和易用性而广泛用于整个 .NET 生态系统。 但是，其强大的功能也让攻击者能够影响目标应用内的控制流。 成功的攻击可能导致攻击者能够在目标进程的上下文中运行代码。（可参考此文档）
- 通过AssemblyLoadContext动态加载程序集可能无法反序列化的问题（比如使用[PluginFactory]插件框架），例如，你在公共库A中封装了序列化辅助方法，在插件程序集B中声明了序列化类型，并通过公共库A中的辅助方法进行序列化或反序列化，最后主程序集C通过独立的AssemblyLoadContext动态加载插件程序集B，此种场景中，B中反序列化时将会引发无法找到程序集的异常。
- 序列化类，必须通过SerializableAttribute特性进行标注
为了解决这些缺陷，我们开源了一款独立的高性能.NET二进制序列化库Xfrogcn.BinaryFormatter（[Github] [Gitee]），该库参考了System.Text.Json库，通过Span与Emit大大提升了序列化性能。此库目标为.NET Standard 2.1。
Xfrogcn.BinaryFormatter具有以下优点：
- 高性能，通过Span与Emit大大提升了性能，其性能超过System.Runtime.Serialization.Formatters库的近四倍
- 更小的序列化尺寸（75%）
- 简单易用，与System.Text.Json基本一致的API接口。
- 反序列化时实例引用的维持
-
类型元数据保留，无需在反序列化时指定目标类型
- 支持反序列化到不同的类型
- 更安全
- 支持AssemblyLoadContext动态加载程序集中类型的序列化
- 无需SerializableAttribute特性标注
- 完善的内置类型支持（[支持的类型]）
一、性能
与.NET内置的System.Runtime.Serialization.Formatters.Binary.BinaryFormatter二进制序列化对比，性能最高可达到它的4倍以上，而序列化结果的大小仅只有它的75%。
以下为通过test/BinaryFormatter.Benchmark性能测试项目获取的性能数据，其中：
- Json指System.Text.Json，可以看到其性能的确强悍
- XfrogcnBinary指本库
- SystemBinaryFormatter指.NET内置二进制序列化库（System.Runtime.Serialization.Formatters.Binary.BinaryFormatter）
- 类别Stream为采用流化方式序列化
- 类别Bytes为直接序列化为Byte数组或从Byte数组反序列化 所有的测试都基于默认配置，（流化方式下默认的缓冲区大小将会明显影响序列化性能）
序列化
| Method | Categories | Mean |
| Json | Stream | 61.41 μs |
| XfrogcnBinary | Stream | 92.97 μs |
| SystemBinaryFormatter | Stream | 291.37 μs |
| Json_Bytes | Bytes | 59.79 μs |
| XfrogcnBinary_Bytes | Bytes | 88.67 μs |
反序列化
| Method | Categories | Mean |
| Json | Stream | 100.12 μs |
| XfrogcnBinary | Stream | 96.34 μs |
| SystemBinaryFormatter | Stream | 334.68 μs |
| Json_Bytes | Bytes | 80.13 μs |
| XfrogcnBinary_Bytes | Bytes | 92.14 μs |
二、如何使用
Xfrogcn.BinaryFormatter库的使用非常简单，基本与System.Text.Json一致：
序列化
序列化到流：
MemoryStream ms = new MemoryStream(); await Xfrogcn.BinaryFormatter.BinarySerializer.SerializeAsync(ms, data);
序列化到byte数组：
var data = Xfrogcn.BinaryFormatter.BinarySerializer.Serialize(data);
反序列化
从流中反序列化：
var obj = await Xfrogcn.BinaryFormatter.BinarySerializer.DeserializeAsync(stream);
从byte数组反序列化：
var obj = Xfrogcn.BinaryFormatter.BinarySerializer.Deserialize(data);
反序列化为指定类型：
var obj = await Xfrogcn.BinaryFormatter.BinarySerializer.DeserializeAsync<T>(stream); 或者： var obj = Xfrogcn.BinaryFormatter.BinarySerializer.Deserialize<T>(data);
当然，你也可以在序列化与反序列化时指定不同的配置()，更详细的使用说明请参考[快速开始]
三、注意事项
- 与System.Text.Json的设计一致，由于类型解析、序列化转换器等缓存都是以配置实例为基础，即每一个配置实例的缓存是独立的，故请使用共享的配置实例，请勿为每一次序列化分配新的配置实例
- 在流模式下，默认缓冲区的大小会极大地影响读取性能，请根据实际情况进行详细的测试以获取合适的缓冲区设置（默认设置可适合大多数场景）
开源需要大家的努力，有兴趣的同学，欢迎提交代码，一起完善！