游戏客户端架构 / 系统课时
JSON、二进制与自定义格式怎么选
JSON、二进制与自定义格式怎么选
存档格式不是单纯的性能选择,它还决定调试难度、文件体积、跨版本迁移和长期维护成本。本节用同一份玩家状态比较 JSON、二进制与自定义格式,并给出适合实际项目的选择顺序。
学习目标
- 能从可读性、体积、性能和兼容成本判断存档格式
- 理解通用二进制格式与自定义二进制格式的主要区别
- 能根据游戏规模选择足够简单且可长期维护的方案
先从维护成本判断
存档最终会长期存在于玩家设备上,因此真正重要的通常不是一次写入快了多少,而是半年后数据结构变化时还能不能安全读取。
| 方案 | 可读性 | 文件体积 | 编解码成本 | 迁移维护成本 |
|---|---|---|---|---|
| JSON | 高 | 较大 | 一般 | 低 |
| 通用二进制格式 | 低 | 较小 | 通常较低 | 取决于格式的兼容规则 |
| 自定义二进制格式 | 极低 | 可精确控制 | 可精确控制 | 高 |
对大多数单机游戏、独立游戏和早期项目,优先选择容易检查和迁移的格式通常比追求最小文件更重要。只有确认存档规模或序列化成本已经成为实际瓶颈,再考虑更紧凑的编码。
JSON 为什么常作为起点
JSON 最大的价值是透明。开发阶段可以直接打开存档检查字段,也容易用脚本修复测试数据。增加普通可选字段时,旧文件通常还能通过默认值继续读取。
代价也很明确:字段名会重复保存,数字使用文本表示,因此相同数据通常比紧凑二进制编码占用更多空间;大型存档频繁序列化时,解析成本也可能变得明显。
二进制格式解决什么问题
“二进制格式”不是一种具体协议。实际项目中至少要区分两类:已有规范的二进制序列化格式,以及项目自己定义的字节布局。
带有明确字段规则或 Schema 的格式可以在压缩体积的同时保留一定的版本演进能力。反过来,一些只面向当前语言运行时的对象序列化机制可能强依赖类名、字段结构甚至运行时实现,并不天然适合作为多年保存的游戏存档协议。
如果采用二进制格式,应先确认三件事:旧字段是否可以保留、未知字段如何处理、字段类型变化是否兼容。格式体积小并不等于迁移成本低。
自定义格式意味着自己维护协议
自定义格式适合数据结构固定、体积或吞吐要求明确,而且团队愿意长期维护协议的场景。例如固定顺序保存整数和浮点数,可以省去字段名和文本转换。
下面用 Python 把同一份状态分别编码成 JSON 和固定布局二进制。这里的例子只比较编码结果,不代表真实游戏中的性能基准。
import json
import struct
state = {
"playerId": 42,
"hp": 87,
"x": 12.5,
"y": -3.0,
}
# 紧凑 JSON 去掉不必要空格,便于观察实际字节数。
json_bytes = json.dumps(
state,
ensure_ascii=False,
separators=(",", ":"),
).encode("utf-8")
# < 表示小端;I、h、f、f 的字段顺序就是自定义协议的一部分。
binary_bytes = struct.pack(
"<Ihff",
state["playerId"],
state["hp"],
state["x"],
state["y"],
)
player_id, hp, x, y = struct.unpack("<Ihff", binary_bytes)
restored = {"playerId": player_id, "hp": hp, "x": x, "y": y}
print(json_bytes.decode("utf-8"))
print("JSON bytes:", len(json_bytes))
print("custom bytes:", len(binary_bytes))
print("restored:", restored)预期输出:
{"playerId":42,"hp":87,"x":12.5,"y":-3.0}
JSON bytes: 41
custom bytes: 14
restored: {'playerId': 42, 'hp': 87, 'x': 12.5, 'y': -3.0}这里自定义格式只有 14 字节,但它隐含了严格约定:第一个字段永远是 32 位无符号整数,第二个字段是 16 位有符号整数,后面两个字段是 32 位浮点数。只要调整字段顺序或类型,旧文件就可能被错误解释。
实际项目怎么选
如果存档只有几十 KB 到几 MB、保存频率不高,而且仍在频繁调整玩法数据,JSON 往往已经足够。它让问题定位和版本迁移更直接,是建立第一版稳定数据模型的低风险方案。
当存档明显偏大、需要频繁保存,或者平台 I/O 与解析成本已经经过测量确认成为瓶颈时,可以迁移到具有成熟兼容规则的二进制协议。此时仍应保留独立的存档版本号,而不是依赖当前代码结构猜测文件版本。
自定义二进制格式应放在最后考虑。只有当通用方案无法满足明确的体积、性能或特殊布局要求时,自行维护字段编号、字节序、类型、版本和迁移逻辑才值得。存档格式真正需要优化的是长期可迁移性,而不是让第一版文件尽可能小。