json格式优化技巧

为什么JSON需要优化？

JSON是前后端数据交换的核心格式，但一份"肥胖"的JSON会带来两个直接问题：传输体积大（拖慢接口响应）和可读性差（调试困难）。优化JSON格式，是每个开发者迟早要面对的课题。

一、压缩技巧：减少传输体积

生产环境下，JSON不需要缩进和换行，压缩后体积可减少30%-60%。

但要注意：压缩只去空格换行，不改数据本身。以下情况不能压缩：

• 需要人工调试的接口 → 保留格式化
• 日志文件 → 用压缩格式传输，存储时再解析
• 配置文件 → 保留格式化，方便版本管理

工具推荐：JSON格式化工具，一键切换格式化/压缩模式。

二、字段命名规范

统一命名风格是JSON规范化的基础。推荐：

• API响应：camelCase（userName, orderId）
• 配置文件：snake_case（max_count, api_key）
• 数据库映射：PascalCase（UserInfo, OrderDetail）

混用风格会让代码里充斥着转换函数，得不偿失。

三、层级设计原则

JSON层级过深会导致：解析性能下降、可读性差、字段重复复制。

✅ 扁平设计：嵌套不超过3层\n✅ 引用id：{"userId": 123} 而不是复制整个用户对象\n❌ 过度嵌套：user.address.city.district.street.name

四、null值处理

不要用null表示"无数据"，用空字符串、空数组、空对象更语义化：

✅ {"name": "", "tags": []}  // 明确区分"无值"和"空集合"

五、数组 vs 对象

选择数据结构的核心原则：需要按顺序遍历用数组，需要快速查找用对象。

✅ 列表数据用数组：[{"id":1}, {"id":2}]\n✅ 配置映射用对象：{"level1": {}, "level2": {}}

六、工具推荐

• JSON格式化工具 — 格式化/压缩/校验
• JSON↔YAML互转 — 配置文件格式互转
• JSON Schema验证 — 校验JSON结构是否符合规范