Json
自动关联目录:Json
Json 的优势只有一个,但很重要:人能读、能改、能 diff。这决定了它的主战场是配置、调试数据、对外接口,而不是高性能或大数据量场景。
数据类型
| Json | 说明 | 常见坑 |
|---|---|---|
object | 键值映射 | 键顺序不保证 |
array | 有序列表 | —— |
string | Unicode 字符串 | 必须是 UTF-8,注意 BOM |
number | 数字 | 没有整数/浮点之分,精度看实现 |
boolean | true / false | —— |
null | 空 | —— |
数字是最大的坑:Json 规范没有整数类型,1 和 1.0 是"相同"的。大整数(超过)在 JS 等实现里会丢精度——需要精确时用字符串。
什么时候不该用 Json
| 场景 | 原因 |
|---|---|
| 网络协议、每帧数据 | 解析慢、体积大(键名重复传输) |
| 大规模存档 | 体积与解析耗时 |
| 需要严格跨端一致 | 数字与键顺序的实现差异 |
| 需要 schema 校验 | Json 本身没有模式 |
工程用法
| 场景 | 建议 |
|---|---|
| 配置表 | 用 Json,但要有校验(schema 或启动期检查) |
| 存档 | 小数据可以;大数据/频繁用二进制 |
| 日志与调试输出 | 很合适 |
| 对外 HTTP 接口 | 事实标准 |
| 编辑器与工具之间交换 | 很合适 |
使用建议
- 允许尾随逗号 / 注释吗?标准 Json 都不允许。配置文件用带注释的变体(JSONC/HJson)更好用,但解析端要配套
- 字段命名统一(
snake_case或camelCase),跨语言时尤其重要 - 必填字段在加载时校验,不要让缺失字段以默认值静默通过
- 不要用手写字符串拼 Json,转义很容易出错
- 大文件用流式解析(SAX),不要整棵 DOM 载入
C++ 里的常见选择
| 库 | 特点 |
|---|---|
| nlohmann/json | 语法最舒服,编译慢、体积大 |
| RapidJSON | 快,SAX/DOM 都支持,API 略繁琐 |
| simdjson | 极快,利用 SIMD,适合大吞吐 |
UE FJsonSerializer | 引擎内置,配合 FJsonObject |
引擎内优先用内置实现(少一份依赖),独立工具链里 RapidJSON 是稳妥的默认选择。
与 Protobuf 的取舍
见 Protobuf。一句话总结:要人读用 Json,要机器快用 Protobuf;两者可以共存——配置用 Json,协议用 Protobuf,用同一份 schema 生成两边。
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/cb358a7b.html
更新于:2026年11月16日