Json

自动关联目录:Json

Json 的优势只有一个,但很重要:人能读、能改、能 diff。这决定了它的主战场是配置、调试数据、对外接口,而不是高性能或大数据量场景。

数据类型

Json说明常见坑
object键值映射键顺序不保证
array有序列表——
stringUnicode 字符串必须是 UTF-8,注意 BOM
number数字没有整数/浮点之分,精度看实现
booleantrue / false——
null空——

数字是最大的坑:Json 规范没有整数类型,1 和 1.0 是"相同"的。大整数(超过2532^{53})在 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 生成两边。