JSON 入门实战:3 步读懂接口返回的数据

举报
yd_252976195 发表于 2026/11/18 09:21:35 2026/11/18
【摘要】 昨天那篇讲了 HTTP:浏览器发请求,服务器回响应。响应体里装的常常是一包数据,而这包数据最常见的格式就是 JSON——前后端之间传数据的通用写法。下面 3 步读懂它。 1. 长相:键值对加两种容器JSON 就是用纯文本写出来的数据,长这样:{ "name": "冒险大转盘", "stars": 1026, "free": true, "tags": ["鸿蒙", "案例"], "...

昨天那篇讲了 HTTP:浏览器发请求,服务器回响应。响应体里装的常常是一包数据,而这包数据最常见的格式就是 JSON——前后端之间传数据的通用写法。下面 3 步读懂它。

1. 长相:键值对加两种容器

JSON 就是用纯文本写出来的数据,长这样:

{
  "name": "冒险大转盘",
  "stars": 1026,
  "free": true,
  "tags": ["鸿蒙", "案例"],
  "author": {
    "name": "张睿基",
    "level": 1
  }
}

规则只有几条:数据是键值对,键一定用双引号包起来;值可以是字符串、数字、布尔值、null,也可以是对象(花括号)和数组(方括号);对象和数组能互相嵌套。记住这三点:键必须有双引号,单引号不行;最后一个值后面不能加逗号;注释写不进去,JSON 里没有注释。

对照着看:name 是字符串,stars 是数字,free 是布尔值,tags 是数组,author 是嵌套对象。接口返回的数据,基本都是这个套路的放大版。

2. 读写:程序怎么拿里面的值

看懂了长相,接下来是程序怎么用它。以 JavaScript 为例,拿到一串 JSON 文本,先解析成对象再取值:

const text = '{"name": "冒险大转盘", "stars": 1026}';
const data = JSON.parse(text);
console.log(data.name);   // 冒险大转盘
console.log(data.stars);  // 1026

反过来,把对象发给服务器之前,要先转成文本:

const obj = { name: "冒险大转盘", stars: 1026 };
const json = JSON.stringify(obj);
console.log(json); // {"name":"冒险大转盘","stars":1026}

记住这一对:JSON.parse 是文本变对象,JSON.stringify 是对象变文本。前端调接口,基本就是发请求、拿到 JSON 文本、parse 之后按字段名取值、把值填进页面——这条链路走通了,大部分接口都能读了。

3. 动手:用 curl 亲眼看一次真实接口

不用写后端,命令行里就能看到一个真实的 JSON 响应:

curl -s https://api.github.com/repos/octocat/Hello-World | python3 -m json.tool | head -20

curl -s 是静默拿回响应体,python3 -m json.tool 是把 JSON 格式化打印出来。回车后会看到 name、full_name、private 这些字段,结构和第 1 步的例子一模一样,只是字段更多。换个接口再跑一次,比如把路径换成另一个公开仓库,对比两次返回的字段——接口文档里列的字段名,就是这样一个个对上号的。

新手最容易踩的三个坑

第一,键没加双引号。{name: "a"} 在 JavaScript 对象里能跑,在 JSON 里就是错的,接口直接报解析失败——复制别人的对象字面量当 JSON 发,最容易栽在这里。

第二,末尾多一个逗号。{"a": 1,} 看着无害,解析器认死理,多个逗号就报错。手写 JSON 时先检查最后一个值后面有没有逗号。

第三,把 JSON 当成只能前端用的东西。Python 的 json.loads、Java 的 ObjectMapper、Go 的 encoding/json,每种语言都有自己的解析方法,格式本身是通用的——这正是它成为接口标准的原因。

小结

JSON 的套路就一句话:键值对写数据,对象和数组做容器,parse 读进来、stringify 发出去。能对照着接口文档读出字段、取出想要的值,这套格式就入门了;明天那篇再讲:页面出了问题,怎么用浏览器开发者工具定位到是哪一步。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。