qktools

JSON 入门教程:语法、结构与常见错误

发布于 2026-06-06

JSON 是当今最流行的数据交换格式,几乎所有 Web 接口、配置文件都在用它。它简洁、易读、跨语言。本教程从零开始带你认识 JSON 的语法规则和常见坑点,帮助你快速看懂并写对 JSON。

JSON 是什么

JSON 全称 JavaScript Object Notation,是一种轻量级的文本数据格式。它用人类可读的方式描述结构化数据,被绝大多数编程语言原生支持,是前后端、服务之间传递数据的通用语言。

基本数据类型

JSON 支持六种值:字符串(用双引号包裹)、数字、布尔值(true / false)、null、对象(花括号)和数组(方括号)。

注意:字符串必须用双引号,不能用单引号;数字不加引号;这些是初学者最容易混淆的地方。

对象与数组

对象是「键值对」的集合,用花括号包裹,键必须是带双引号的字符串,例如 {"name": "小明", "age": 18}。数组是「有序值列表」,用方括号包裹,例如 [1, 2, 3]。

对象和数组可以任意嵌套,从而表达复杂的层级结构,比如一个用户对象里包含一个地址对象和一个标签数组。

最常见的格式错误

新手最常踩的坑有:最后一个元素后多了逗号(尾逗号)、用了单引号、键名没加引号、括号或引号不匹配、以及把注释写进了 JSON(标准 JSON 不支持注释)。

这些错误都会导致解析失败。遇到报错时,先按提示定位行号,再重点检查上述几类问题。

用工具校验和格式化

实际开发中,把混乱的 JSON 美化成带缩进的格式能极大方便阅读和排错。使用 qktools 的 JSON 格式化工具可以一键格式化、压缩并校验 JSON,错误会精确提示原因。

如果需要把 JSON 转成表格,还可以用 JSON 转 CSV 工具,方便在表格软件中查看和处理。

相关工具