Serialization
自动关联目录:Serialization
序列化要同时满足三件事:跨端一致、能演进、够快。三者互相拉扯,选型的本质就是决定牺牲哪一个。
本目录
| 笔记 | 内容 |
|---|---|
| Json | 文本格式:可读性、调试、配置 |
| Protobuf | 二进制格式:体积、速度、版本兼容 |
选型对比
| Json | Protobuf | UE 自带(FArchive) | |
|---|---|---|---|
| 可读性 | 高(文本) | 无(二进制) | 无 |
| 体积 | 大(键名重复) | 小(编号 + varint) | 取决于实现 |
| 速度 | 慢(文本解析) | 快 | 快 |
| 模式(schema) | 无 | 有(.proto) | 靠 USTRUCT 反射 |
| 版本演进 | 靠约定 | 字段编号天然支持 | 需要自己处理 |
| 跨语言 | 极好 | 好 | 只在 C++/蓝图内 |
| 适合 | 配置、调试、对外接口 | 网络协议、存档、大数据量 | 引擎内资源与存档 |
决策树
需要人读/改吗?
├── 是 → Json(配置、本地调试数据)
└── 否
├── 要跨版本演进 / 跨语言? → Protobuf
└── 只在引擎内、跟着 USTRUCT 走? → UE 自带序列化跨端一致的三条经验
- 不要依赖字段顺序:Json 对象的键顺序在不同实现里不保证;Protobuf 靠编号天然免疫
- 浮点数要小心:文本表示(
%.17g)、精度、-0、NaN/Inf都可能造成两端不一致。需要严格一致时用定点数或整数放大 - 字节序与字符编码:二进制格式要显式规定端序,字符串统一 UTF-8
演进规则(无论用什么格式)
| 规则 | 说明 |
|---|---|
| 只增不改 | 字段编号/名字一旦发布就不要复用 |
| 新字段必须可缺省 | 否则老版本读不了新数据 |
| 删除字段时保留占位 | 避免后来的字段意外复用旧编号 |
| 枚举保留未知值处理 | 新枚举值到旧版本要有默认行为 |
| 写版本号 | 大改时才有回旋余地 |
常见坑
| 坑 | 说明 |
|---|---|
用 float 存金币/时间 | 精度与跨端不一致,用整数 |
| 把内存指针/索引写进存档 | 反序列化后失效 |
| 依赖默认构造的初始值 | 显式写全更稳 |
| 二进制存档不做版本校验 | 结构一改直接崩 |
| 序列化热路径频繁分配 | 复用缓冲区 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/b7d46781.html
更新于:2026年11月16日