JSON 到底是什么？2025 年最全数据格式“避坑”指南

原创于 2025-12-17 16:13:29 发布 · 428 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#json

在当今的互联网世界，如果说 TCP/IP 是铺路石，那么 JSON 就是上面跑的“通用货币”。

JSON 数据格式（详解版）

无论你是做前端、后端，还是搞大数据、AI，只要涉及数据交换，就绕不开 JSON (JavaScript Object Notation)。它以“轻量级、易读、通用”的特性，彻底击败了曾经的霸主 XML，成为了 Web 开发事实上的标准。

但你真的懂 JSON 吗？为什么你的 JSON 解析会报错？为什么大厂接口都用它？今天我们就来一次彻底的**“降维打击”**，把 JSON 揉碎了讲清楚。

一、核心解构：JSON 的两根“定海神针”

JSON 之所以简单，是因为它只有两种基本结构。不管多么复杂的数据，都是由这两种结构像搭积木一样堆出来的。

1. 对象 (Object) —— 无序的键值对

你可以把它想象成一个**“字典”或者“哈希表”**。

特征：用花括号 { } 包裹。
结构："key": value。
关键点：键（Key）必须是字符串，且必须用双引号包裹（这是新手最容易踩的坑！）。

看个例子：

{
    "list" : [ 
        {
            "name": "Apifox",
            "ID": 2,
            "city": "Guangzhou"
        }
    ] 
}

2. 数组 (Array) —— 有序的值列表

你可以把它想象成一个**“清单”**。

特征：用方括号 [ ] 包裹。
结构：值之间用逗号 , 分隔。
关键点：数组里的元素可以是字符串、数字，甚至可以是另一个复杂的对象（套娃开始）。

看个例子：

[  "apple",  "banana",  "orange"]

二、 6 种数据类型：JSON 的原子单位

JSON 的强大在于它的包容性，它可以表示以下 6 种值（Value）：

字符串 (String)：

铁律：必须使用双引号 " "。单引号 ' ' 是非法的，这与 JavaScript 代码不同，切记！
示例："name": "Apifox"

数字 (Number)：

灵活：整数、浮点数都可以，不需要引号。
示例："age": 30, "weight": 65.5

布尔值 (Boolean)：

逻辑：只有 true 和 false，全部小写，不加引号。
示例："isStudent": true

Null：

占位：表示空值，不加引号。
示例："middleName": null

对象 (Object) & 数组 (Array)：

这就构成了无限嵌套的可能性。

🔥 进阶：复杂嵌套实战

在实际业务中，我们通常处理的是“对象套数组，数组套对象”的复杂结构。比如下面这个用户信息：

{
    "id": 101,
    "name": "Jane Doe",
    "is_active": true,
    "roles": ["admin", "editor"],  // 数组：由字符串组成
    "contact": {                   // 对象：嵌套对象
        "email": "jane.doe@example.com",
        "phone": "123-456-7890"
    },
    "preferences": {
        "notifications": {
            "email": true,
            "sms": false
        }
    }
}

三、避坑指南：新手最容易犯的 4 个错误

很多开发者代码跑不通，90% 都是因为 JSON 格式不规范。请把下面这几条刻在脑子里：

标点符号必须是英文：严禁使用中文冒号、逗号或双引号。
Key 必须加双引号：{ name: "Jack" } 是错的，{ "name": "Jack" } 才是对的。
严禁单引号：JSON 里没有单引号的位置，字符串一律用双引号。
不仅是末尾逗号：对象或数组的最后一个元素后面，不能加逗号（虽然 JS 允许，但在标准 JSON 中这是语法错误）。

四、灵魂拷问：JSON vs XML，谁才是王者？

在 20 年前，XML 统治着数据交换的世界。为什么 JSON 能后来居上？

我们可以通过一个直观的对比来看：

维度	JSON	XML	结论
可读性	清爽，无冗余标签	繁琐，到处是 `< >`	JSON 胜
体积	小，节省带宽	大，包含大量标签	JSON 胜
解析速度	极快（原生支持）	较慢（需 DOM 解析）	JSON 胜
描述能力	简单直接	极强（支持属性、命名空间）	XML 胜在复杂场景

实战案例对比：

XML 写法：

<book>
  <title>Harry Potter</title>
  <author>J.K. Rowling</author>
  <year>2005</year>
</book>

JSON 写法：

{
  "title": "Harry Potter",
  "author": "J.K. Rowling",
  "year": 2005
}

显而易见，对于 99% 的互联网应用场景，JSON 都是更优的选择。但在一些需要极强严谨性（如银行配置文件）的古老系统中，XML 依然有一席之地。

五、 JSON 的局限性（真相揭秘）

JSON 虽然好用，但也不是万能的。你需要知道它的短板：

没有注释：你不能在 JSON 里写 // 这是一个用户ID。这导致它作为配置文件时，可维护性不如 YAML。
处理不了二进制：想传图片或视频？你得先转成 Base64 字符串，这会增加体积。
类型单一：它只有字符串、数字等基础类型，没有“日期”类型（通常用字符串表示）。

六、拒绝手写：如何高效生成 JSON？

虽然 JSON 语法简单，但手动去写几百行的 JSON 数据，不仅效率低，还容易少写个逗号导致报错。

这时候，你需要一把趁手的“兵器”。

强烈推荐 Apifox。它不仅仅是 API 调试工具，更是JSON 生产力神器。

Apifox 生成 JSON 数据

1. 智能生成 JSON

在 Apifox 中，你只需要定义好字段名和类型（比如 name 是 string，age 是 number），它就能自动生成符合规范的 JSON 数据。

免费使用 Apifox

2. 动态 Mock 数据

前端开发最头疼的就是后端接口还没好。用 Apifox，你可以直接利用其 Mock 功能，生成结构完美、内容随机的 JSON 数据供前端调用。

怎么做？

新建接口。
定义返回结构（Schema）。
点击发送，直接获得标准 JSON。

立即体验 Apifox

总结

JSON 是现代 Web 开发的基石。掌握它的结构和规范，是你成为合格开发者的第一步。而善用像 Apifox 这样的工具，则能让你从繁琐的格式校验中解放出来，专注于业务逻辑的实现。