JSON是什么?JSON格式详解
JSON 是一种轻量级的数据交换格式,常用于 API 接口、前后端通信、配置文件和数据存储。它用清晰的文本结构表示对象、数组及基础数据类型,既方便开发者阅读,也便于不同编程语言解析。理解 JSON 格式,是进行 Web 开发、接口调试和后端开发的基础。
什么是JSON?
JSON定义
JSON 的全称是 JavaScript Object Notation,中文通常称为“JavaScript 对象表示法”。它是一种使用纯文本表示结构化数据的数据交换格式。虽然语法来源于 JavaScript 对象字面量,但 JSON 不是 JavaScript,也不是编程语言或数据库。Go、Java、Python、PHP、Rust、C# 等语言都能独立解析和生成 JSON。
{
"name": "Steven",
"age": 28,
"isDeveloper": true
}
这段 JSON 描述了一个用户,其中包含姓名、年龄和是否为开发者三个字段。JSON 只负责描述数据,不能包含函数、变量声明或条件语句。它的优势是结构简洁、人能阅读、机器容易解析,而且不会把数据绑定在某一种后端语言上。
JSON的发展和应用场景
JSON 从 JavaScript 对象语法发展而来,随着 Web API 和前后端分离架构普及,逐渐成为互联网最常用的数据交换格式之一。现代应用通常由前端负责界面展示,后端通过 API 提供数据,JSON 正好可以在浏览器、移动端和服务器之间传递字段与嵌套关系。
- REST API 的请求参数和响应结果
- 前端、后端和移动端之间的数据交换
- Node.js、编辑器和构建工具的配置文件
- 日志、消息队列和 Webhook 事件数据
- NoSQL 数据库中的文档存储
- OpenAPI、JSON Schema 等接口规范
JSON基本语法
一个 JSON 值可以是对象、数组、字符串、数字、布尔值或者 null。JSON 的结构并不复杂,但规则比 JavaScript 对象更严格:字符串和对象键必须使用双引号,不能写注释,最后一个成员后不能保留逗号。
对象 Object
对象使用花括号 {} 表示,内部由多组键值对组成。键和值之间使用冒号,多组数据之间使用逗号。对象可以继续嵌套对象,适合表达用户资料、订单和系统配置等层级数据。
{
"id": 1001,
"username": "steven",
"profile": {
"city": "Shanghai",
"experience": 5
}
}
数组 Array
数组使用方括号 [] 表示,元素之间使用逗号分隔。数组元素可以是任意 JSON 类型。虽然同一个数组允许混合不同类型,但 API 列表通常保持一致的数据结构,以便前端定义类型并稳定渲染。
[
{ "id": 1, "name": "JSON格式化工具" },
{ "id": 2, "name": "JSON校验工具" }
]
Key-Value结构
对象以 Key-Value,也就是“键值对”的形式组织数据。例如 "language": "Go" 中,language 是键,Go 是值。对象的键必须是双引号字符串;{ language: "Go" } 是 JavaScript 对象写法,并不是合法 JSON。
字符串、数字、布尔值和null
- 字符串必须使用双引号;内容中的双引号需要写成
\"。 - 数字可以是整数、小数或科学计数法,但不能是
NaN、Infinity 或 -Infinity。 - 布尔值只有小写的
true 和 false;"true" 是字符串,不是布尔值。 null 表示空值,不等同于空字符串、数字 0 或字段缺失。
对于雪花 ID、订单号等超大整数,建议使用字符串传输。JavaScript 的 Number 无法精确保存所有超过 2^53 - 1 的整数,直接按数字解析可能导致 ID 末位发生变化。
JSON示例代码
下面的完整示例同时包含对象、数组、字符串、数字、布尔值和 null。阅读时先判断根节点是对象还是数组,再沿着键逐层查找数据。
{
"id": 1001,
"name": "Steven",
"active": true,
"email": null,
"skills": ["Go", "JavaScript", "Docker"],
"profile": {
"city": "Shanghai",
"experience": 5
}
}
JavaScript 使用 JSON.parse() 把 JSON 字符串解析为对象,使用 JSON.stringify() 将对象序列化为 JSON 字符串。解析外部输入时要捕获异常,不能默认接口、日志或用户输入一定合法。
const jsonText = '{"name":"Steven","active":true}';
const user = JSON.parse(jsonText);
const output = JSON.stringify(user, null, 2);
console.log(output);
Go 可以通过标准库 encoding/json 将 JSON 映射到结构体。结构体标签负责指定 JSON 字段名,json.Unmarshal 返回的错误必须处理。
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string `json:"name"`
Active bool `json:"active"`
}
func main() {
data := []byte(`{"name":"Steven","active":true}`)
var user User
if err := json.Unmarshal(data, &user); err != nil {
panic(err)
}
fmt.Println(user.Name)
}
JSON的常见使用场景
API接口
JSON 是 REST API 最常见的请求和响应格式。客户端可以发送用户资料,服务端再返回状态码、消息和业务数据。客户端和服务端即使使用不同语言,也能通过约定字段名称、类型和嵌套结构完成通信。
{
"code": 0,
"message": "success",
"data": {
"id": 1001,
"username": "steven"
}
}
前后端数据传输
在前后端分离项目中,前端通常通过 Fetch 或 Axios 请求后端接口,再把响应 JSON 转成页面状态。此时 JSON 是双方的数据契约;除了语法正确,还要明确字段类型、是否必填、是否允许为空以及错误响应结构。
配置文件
许多开发工具使用 JSON 保存配置,例如 Node.js 的 package.json。标准 JSON 不支持注释,如果配置需要注释,可以考虑 JSONC、YAML 或 TOML,但必须先确认运行工具支持对应格式。
数据存储
MongoDB 等文档数据库使用类似 JSON 的文档结构,部分关系型数据库也提供 JSON 字段。不过,不应把所有业务数据都塞入 JSON:需要频繁查询、排序、关联和建立索引的核心字段,通常仍应使用明确的数据库列。JSON 字段更适合扩展属性和变化较多的配置。
JSON和XML的区别
JSON 和 XML 都能表示结构化数据,但二者的设计重点不同。JSON 通常更适合现代 Web API;XML 则仍适用于需要命名空间、混合文档内容或成熟 Schema 体系的企业场景。
| 对比项 | JSON | XML |
|---|
| 数据结构 | 对象、数组和基础类型 | 标签、属性和文本节点 |
| 可读性 | 结构简洁,适合接口数据 | 标签较多,文档通常更长 |
| 数据类型 | 原生支持数字、布尔值和 null | 通常以文本表示,需要额外定义类型 |
| 数组表示 | 原生支持数组 | 通常通过重复标签表达 |
| 注释 | 标准 JSON 不支持 | 支持 |
| 命名空间 | 不支持 | 原生支持 |
| 常见场景 | Web API、配置和数据交换 | 文档、企业系统和复杂协议 |
JSON 没有 XML 那样的成对标签,通常体积更小、在浏览器中处理更方便。但 JSON 并非在所有场景都优于 XML,最终选择应由数据结构、协议规范和现有系统约束决定。
常见JSON错误
缺少引号
对象键和字符串值必须使用双引号。{ name: 'Steven' } 在 JavaScript 中可能成立,但不是合法 JSON;正确写法是 { "name": "Steven" }。单引号是从代码片段复制 JSON 时最常见的错误之一。
多余逗号
对象最后一个属性或数组最后一个元素后不能保留逗号。尾逗号在部分 JavaScript 场景中可用,但严格的 JSON 解析器会直接报错。
{
"name": "Steven",
"age": 28,
}
其他格式错误
- 对象或数组元素之间缺少逗号
- 字符串中的双引号没有转义
- 花括号或方括号没有闭合
- 使用了
undefined、NaN 或 Infinity - 布尔值写成
True 或 False - 在标准 JSON 中添加
// 或 /* */ 注释 - JSON 被重复序列化,字符串中出现大量反斜杠
内容较长时,不要靠肉眼反复数括号。可以把数据粘贴到 JSON校验工具,先确认语法并定位错误,再继续格式化或转换。校验器只能判断语法是否合法,字段是否符合业务要求仍需通过 JSON Schema、OpenAPI 或业务代码检查。
如何格式化JSON?
接口响应、日志记录和数据库内容经常被压缩成一行。压缩格式适合机器传输,却不方便开发者观察对象嵌套与数组层级。JSON 格式化会增加缩进和换行,但不应该修改字段名称、字段值或数组顺序。
{"id":1001,"name":"Steven","skills":["Go","JavaScript"],"active":true}
打开站内 JSON格式化工具,粘贴 JSON 后点击格式化,即可展开层级;需要放入请求体或日志时,也可以重新压缩成单行。更完整的操作说明可阅读 JSON格式化方法大全。
- 复制需要处理的 JSON 文本。
- 将内容粘贴到输入区域。
- 点击格式化并检查对象、数组层级。
- 根据需要复制格式化结果或压缩成单行。
如果格式化失败,应先查看解析错误,再用 JSON校验工具 检查缺少逗号、引号或括号等问题。需要把 JSON 转为 Go Struct、TypeScript、Java、YAML 或 CSV 时,可以进入 JSON转换工具 选择对应功能。
处理密码、Token、手机号等敏感数据前应先脱敏,并确认所用工具的隐私策略。本站 JSON 工具默认在浏览器本地处理数据,适合日常接口联调,但团队仍应建立统一的数据安全规范。
相关工具
常见问题
JSON是什么格式的文件?
JSON 是一种保存结构化数据的纯文本格式,文件扩展名通常为 .json。它可以由普通文本编辑器打开,也可以被各种编程语言和开发工具解析,文件一般采用 UTF-8 编码。
JSON和JavaScript对象有什么区别?
JSON 是用于存储和传输数据的文本格式,JavaScript 对象是程序运行时的内存结构。JavaScript 对象可以包含方法、undefined、单引号和不加引号的属性名,而标准 JSON 不允许这些写法。
如何判断JSON格式是否正确?
可以使用编程语言提供的 JSON 解析函数,解析失败通常说明语法不合法。较长的数据建议使用 JSON 校验工具,它可以辅助定位缺少逗号、引号或括号等问题。
JSON为什么不能使用单引号?
JSON 标准规定字符串和对象键必须使用双引号,以便不同语言和解析器按照统一规则处理数据。单引号可能是合法的 JavaScript 字符串语法,但不是合法的 JSON 字符串语法。
JSON格式化会修改原始数据吗?
正常的 JSON 格式化只调整缩进、空格和换行,不会修改字段和值。对于密码、Token 和个人信息等敏感数据,建议先脱敏,并使用明确说明本地处理方式的工具。