如何在protobuf-net中序列化实现IEnumerable的RoaringBitmap类型

protobuf-net内置了默认类型识别规则：所有实现IEnumerable接口的类型会被自动判定为集合类型，序列化时优先走集合处理分支。该分支优先级高于Surrogate代理配置，因此你之前写的代理逻辑根本没有被执行，框架会先按集合规则校验类型，抛出要求实现ICollection的异常。
这种默认逻辑确实存在设计缺陷，对于非托管优化的位图类、无限生成器、超大型数据集这类实现了IEnumerable但不适合枚举序列化的类型，会造成体积爆炸或者运行时卡死。

只需要在注册类型时显式告诉protobuf-net不要把RoaringBitmap当作集合处理，再绑定你已经写好的Surrogate即可，全程不需要修改RoaringBitmap的源码，也不会触发任何IEnumerable枚举逻辑。
修正后的静态构造函数代码如下：

static ProtobufSerializer()
{
    var model = ProtoBuf.Meta.RuntimeTypeModel.Default;
    // 注册RoaringBitmap，false参数表示不自动扫描类型的属性/字段
    var bitmapMeta = model.Add(typeof(RoaringBitmap), false);
    // 核心配置：标记该类型不是集合，跳过所有IEnumerable相关的序列化逻辑
    bitmapMeta.IsCollection = false;
    // 绑定你写好的字节数组代理
    bitmapMeta.SetSurrogate(typeof(RoaringBitmapSurrogate));
}

你原有的Surrogate转换逻辑、序列化/反序列化通用方法都可以直接保留，不需要修改。

• 序列化时会直接调用RoaringBitmap.Serialize()输出原生紧凑格式的字节数组，最终序列化体积稳定在百字节级别，完全不会出现枚举所有置位位导致的1GB体积问题
• 反序列化时会直接读取字节数组调用RoaringBitmap.Deserialize()还原实例，性能和原生序列化一致
• 如果你希望全局规避IEnumerable自动序列化的风险，可以在模型配置时设置model.AutoAddTypes = false，后续所有需要序列化的类型都手动注册，避免框架误判。

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