游戏客户端架构 / 系统课时

JSON、二进制与自定义格式怎么选

JSON、二进制与自定义格式怎么选

存档格式不是单纯的性能选择,它还决定调试难度、文件体积、跨版本迁移和长期维护成本。本节用同一份玩家状态比较 JSON、二进制与自定义格式,并给出适合实际项目的选择顺序。

学习目标

  • 能从可读性、体积、性能和兼容成本判断存档格式
  • 理解通用二进制格式与自定义二进制格式的主要区别
  • 能根据游戏规模选择足够简单且可长期维护的方案

先从维护成本判断

存档最终会长期存在于玩家设备上,因此真正重要的通常不是一次写入快了多少,而是半年后数据结构变化时还能不能安全读取。

方案 可读性 文件体积 编解码成本 迁移维护成本
JSON 高 较大 一般 低
通用二进制格式 低 较小 通常较低 取决于格式的兼容规则
自定义二进制格式 极低 可精确控制 可精确控制 高

对大多数单机游戏、独立游戏和早期项目,优先选择容易检查和迁移的格式通常比追求最小文件更重要。只有确认存档规模或序列化成本已经成为实际瓶颈,再考虑更紧凑的编码。

JSON 为什么常作为起点

JSON 最大的价值是透明。开发阶段可以直接打开存档检查字段,也容易用脚本修复测试数据。增加普通可选字段时,旧文件通常还能通过默认值继续读取。

代价也很明确:字段名会重复保存,数字使用文本表示,因此相同数据通常比紧凑二进制编码占用更多空间;大型存档频繁序列化时,解析成本也可能变得明显。

二进制格式解决什么问题

“二进制格式”不是一种具体协议。实际项目中至少要区分两类:已有规范的二进制序列化格式,以及项目自己定义的字节布局。

带有明确字段规则或 Schema 的格式可以在压缩体积的同时保留一定的版本演进能力。反过来,一些只面向当前语言运行时的对象序列化机制可能强依赖类名、字段结构甚至运行时实现,并不天然适合作为多年保存的游戏存档协议。

如果采用二进制格式,应先确认三件事:旧字段是否可以保留、未知字段如何处理、字段类型变化是否兼容。格式体积小并不等于迁移成本低。

自定义格式意味着自己维护协议

自定义格式适合数据结构固定、体积或吞吐要求明确,而且团队愿意长期维护协议的场景。例如固定顺序保存整数和浮点数,可以省去字段名和文本转换。

下面用 Python 把同一份状态分别编码成 JSON 和固定布局二进制。这里的例子只比较编码结果,不代表真实游戏中的性能基准。

python
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)

预期输出:

text
{"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 与解析成本已经经过测量确认成为瓶颈时,可以迁移到具有成熟兼容规则的二进制协议。此时仍应保留独立的存档版本号,而不是依赖当前代码结构猜测文件版本。

自定义二进制格式应放在最后考虑。只有当通用方案无法满足明确的体积、性能或特殊布局要求时,自行维护字段编号、字节序、类型、版本和迁移逻辑才值得。存档格式真正需要优化的是长期可迁移性,而不是让第一版文件尽可能小。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

JSON、二进制与自定义格式怎么选

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通