合普知识库
柔彩主题三 · 更轻盈的阅读体验

JSON格式例子:一看就懂的实用写法(实战经验分享)

发布时间:2025-12-14 12:54:57 阅读:263 次

很多人第一次接触 JSON 时,觉得它神秘又难懂。其实 JSON 就像一份结构清晰的购物清单,用简单的规则把数据组织起来,让程序能快速读懂。

什么是 JSON

JSON 全称是 JavaScript Object Notation,是一种轻量级的数据交换格式。它看起来像编程语言里的对象或字典,但本质是文本,适合在网络上传输。

最基础的 JSON 例子

比如你想描述一个人的基本信息,可以用下面这种方式:

{
  "name": "张伟",
  "age": 32,
  "city": "上海",
  "married": false
}

这里的每一项都由键和值组成,键必须用双引号包围,值可以是字符串、数字、布尔值,也可以是数组或另一个对象。

包含数组的 JSON 示例

有时候一个字段会对应多个值,比如某人的兴趣爱好。这时候就可以用数组,用方括号 [] 包裹:

{
  "username": "lily",
  "hobbies": ["看书", "跑步", "摄影"],
  "login_count": 48
}

这个结构在用户注册、个人资料页面中非常常见,后端返回这样的数据,前端就能自动展示对应内容。

嵌套对象的 JSON 写法

现实中的数据往往有层级。比如订单信息,不仅有下单人,还有收货地址:

{
  "order_id": "20240415001",
  "user": {
    "name": "李娜",
    "phone": "138****1234"
  },
  "address": {
    "province": "广东省",
    "city": "深圳市",
    "detail": "南山区科技园路123号"
  },
  "paid": true
}

这种嵌套结构能让数据表达更丰富,也更容易被程序逐层解析。

实际应用场景

你在手机 App 上刷新朋友圈,新动态就是通过 JSON 返回的。每条动态可能包含用户名、头像、发布时间、文字内容和点赞列表,这些都打包在一个 JSON 对象里传给客户端。

再比如天气接口,返回的数据长这样:

{
  "location": "北京",
  "temperature": 24,
  "condition": "晴",
  "forecast": [
    { "day": "周一", "high": 26, "low": 16 },
    { "day": "周二", "high": 28, "low": 18 }
  ]
}

前端拿到后,直接遍历 forecast 数组就能生成未来两天的天气卡片。

写 JSON 的几个注意事项

别忘了键一定要用双引号,单引号不行;最后一个元素后面不能加逗号;字符串只能用双引号包裹。这些小细节一旦出错,程序就可能读不懂。

现在主流编辑器都会对 JSON 高亮并检查格式,写的时候多留意红色波浪线,基本就能避开大部分问题。