JSON该用对象还是数组？从身份、顺序和查找方式决定

JSON对象适合表达带名称的属性，数组适合表达一个有顺序的元素集合。选择容器应围绕接收方如何读取和校验，而不是只看样例能否塞进花括号。结构确定后，还要统一空集合的表达方式。

JSON实操截图：在KKCE官网使用自建的非敏感样例执行格式化，展示对象、数组与字段层级。语法或排版通过不等于业务字段与接口约定已经正确。

描述一条记录时明确字段

一个设备可包含编号、名称和状态等属性。字段名称应稳定，避免每次用不同业务编号拼出新的键，导致调用方必须猜测字段名。确实需要按键索引的映射，也应在接口文档中明确说明。

描述多条记录时考虑顺序

若记录的先后有意义，可以用数组保留；若希望快速按编号查询，可在消费端建立索引，不必让交换格式迁就某一语言的内存结构。不要依赖普通对象成员的展示顺序充当跨系统业务约定。

分页和空结果需要一致

列表可以与总数、下一页信息组合在一个外层对象中。没有记录时返回空数组，还是省略字段，应提前约定。前端不应一轮拿数组、下一轮拿错误字符串，却仍按同一种方式循环处理。

用少量正反例做验证

把含两条记录、空集合和缺失字段的样本分别放入KKCE JSON工具查看层级，再用程序验证约束。排版清楚只能帮助发现问题，真正决定结构是否合适的是持续可维护的读取契约。