Serialization

自动关联目录:Serialization

序列化要同时满足三件事:跨端一致、能演进、够快。三者互相拉扯,选型的本质就是决定牺牲哪一个。

本目录

笔记内容
Json文本格式:可读性、调试、配置
Protobuf二进制格式:体积、速度、版本兼容

选型对比

JsonProtobufUE 自带(FArchive)
可读性高(文本)无(二进制)无
体积大(键名重复)小(编号 + varint)取决于实现
速度慢(文本解析)快快
模式(schema)无有(.proto)靠 USTRUCT 反射
版本演进靠约定字段编号天然支持需要自己处理
跨语言极好好只在 C++/蓝图内
适合配置、调试、对外接口网络协议、存档、大数据量引擎内资源与存档

决策树

需要人读/改吗?
├── 是 → Json(配置、本地调试数据)
└── 否
    ├── 要跨版本演进 / 跨语言? → Protobuf
    └── 只在引擎内、跟着 USTRUCT 走? → UE 自带序列化

跨端一致的三条经验

  1. 不要依赖字段顺序:Json 对象的键顺序在不同实现里不保证;Protobuf 靠编号天然免疫
  2. 浮点数要小心:文本表示(%.17g)、精度、-0、NaN/Inf 都可能造成两端不一致。需要严格一致时用定点数或整数放大
  3. 字节序与字符编码:二进制格式要显式规定端序,字符串统一 UTF-8

演进规则(无论用什么格式)

规则说明
只增不改字段编号/名字一旦发布就不要复用
新字段必须可缺省否则老版本读不了新数据
删除字段时保留占位避免后来的字段意外复用旧编号
枚举保留未知值处理新枚举值到旧版本要有默认行为
写版本号大改时才有回旋余地

常见坑

坑说明
用 float 存金币/时间精度与跨端不一致,用整数
把内存指针/索引写进存档反序列化后失效
依赖默认构造的初始值显式写全更稳
二进制存档不做版本校验结构一改直接崩
序列化热路径频繁分配复用缓冲区