JSON 描述的是数据
JSON 是一种用文本表示结构化数据的格式。完整文档只能有一个根值,可以是对象、数组、字符串、数字、布尔值 true 或 false,以及 null。对象用花括号包住键值对,键必须使用双引号;数组用方括号包住有序值。两类结构可以相互嵌套,适合表达配置、接口响应和数据记录。
例如,下面记录一个工具箱页面及其标签:
这里 title 是字符串,published 是布尔值,version 是数字,tags 是字符串数组。排错时先判断值的类型,再看它是否处在正确位置。
{
"title": "阿晨的工具箱",
"published": true,
"version": 1,
"tags": ["JSON", "排错"]
}四条最容易违反的语法规则
第一,字符串必须使用双引号,单引号不属于合法 JSON。第二,对象和数组成员之间必须用逗号分隔;漏逗号和多逗号都会导致解析失败。第三,对象键必须使用双引号,不能使用无引号键。第四,JSON 不接受注释,也不允许尾随注释。
复制内容时,弯引号、全角逗号和零宽字符可能混入文本。字符串中的换行应写成反斜杠加 n,双引号前需要反斜杠转义。数字后不能紧跟字符,true、false 与 null 必须小写。
按报错位置缩小范围
解析器通常会给出行号和列号,例如 Unexpected token } at line 4 column 1。先找到对应行,再检查报错位置之前最近的逗号、引号或括号。提示 Unexpected end of JSON input 时,往往有括号未闭合或文件被截断,应从根值重新核对每一层结构。
可以把排错固定成四步:确认根值类型;逐层检查逗号和括号;检查所有字符串的双引号;搜索全角符号、注释和尾逗号。每次只修复一个问题后重新解析,避免一次改动太多而掩盖错误位置。
一个修复示例与验证方法
下面的内容有两处错误:工具名使用单引号,版本数组末尾多了逗号。改正后,应让解析器重新读取文件。在 Python 中可以执行 import json; data=json.load(open("config.json", encoding="utf-8")),成功后再访问 data["tool"]["name"] 核对值。
如果格式合法但程序仍报错,就进入了数据契约层:字段是否齐全、类型是否正确需要另行校验。例如 version 写成字符串 "2" 时格式有效,却不符合数字约定。先解决语法错误,再验证字段与业务约束。
错误:{ "tool": { "name": '工具箱' }, "versions": [1, 2,] }
修复:{ "tool": { "name": "工具箱" }, "versions": [1, 2] }