如何格式化、美化和验证 JSON 数据
粘贴 JSON 文本后,按需要设置缩进、对象键排序或紧凑输出,再执行格式化即可同时检查其可解析性。输入无法解析时,工具会报告失败并提供解析错误详情。
先了解工具能做什么
JSON 格式化工具用于整理 JSON 文本,让层级结构更容易阅读,同时检查提交内容是否能够被解析。它适合处理接口响应、配置片段或需要排查语法的 JSON 文本。成功解析后,你可以根据阅读或传输需要调整缩进、排序对象键,或者改用紧凑输出。包含中文姓名、标签等 Unicode 字符的有效 JSON,也可以在格式化文本中保留。使用时应先确认手上的内容是 JSON 文本,再根据用途选择显示方式。
操作步骤:格式化并检查 JSON
- 准备要处理的 JSON 文本。输入框可以不填写;如果输入为空或只有空白字符,工具会把它视为没有提供 JSON,并返回成功状态,但不会生成格式化内容。因此,需要获得格式化结果时,应提交实际的 JSON 文本。
- 将文本粘贴到输入区域。可以先保留默认设置,默认缩进值为 2;如果希望层级之间更宽或更紧,可按阅读需要调整缩进值。缩进主要改变输出的排版方式,不代表对数据内容增加规则。
- 按需要决定是否启用对象键排序。这个选项默认关闭,关闭时不会主动按顺序排列对象键;启用后,格式化结果中的对象键会按顺序排列。若你需要对照原始键的排列,处理前应注意这个设置。
- 如果目标是节省显示空间或传输空间,可以启用紧凑输出。启用后,结果不使用缩进排版,而是采用紧凑的逗号和冒号分隔方式。需要快速阅读层级时,则保留关闭状态更合适。
- 执行格式化或检查操作,并查看返回内容与状态。有效 JSON 会生成格式化后的 JSON 文本;无法解析的文本会报告失败,返回内容仍保留你提交的文本,并附带解析错误详情。根据详情修改原文后再提交,例如检查字符串引号、逗号以及括号是否配对。
如何理解结果
成功状态表示提交的 JSON 文本已经能够被解析,并按照当前设置生成了文本结果。此时可以通过缩进观察嵌套层级,也可以根据是否启用键排序来理解对象键的排列变化。启用紧凑输出后,结果的重点是减少排版空白,因此不应期待它继续保持多行缩进外观。中文等 Unicode 字符如果出现在有效 JSON 中,可以继续出现在格式化文本里。
失败状态表示这次提交未能通过 JSON 解析。返回的原文本有助于与修改前的内容进行对照,解析错误详情则用于定位语法问题。修正后重新执行即可再次检查。若输入为空或只有空白字符,成功状态只表示没有提供 JSON,不代表工具生成了可用的 JSON 文本。
使用示例
你需要把包含中文姓名和标签的单行 JSON 整理成便于阅读的文本。
将包含 name 和 tags 的 JSON 对象,例如 {"name":"小林","tags":["接口","配置"]},粘贴到输入区域,保留默认缩进后执行格式化。
结果应包含成功状态和格式化后的 JSON 文本,其中中文字符仍可保留;如果启用紧凑输出,文本会采用紧凑的逗号和冒号分隔方式。
使用限制
- 这项工具面向 JSON 文本的可解析性检查与格式化,不应当当作模式验证器、JSONPath 工具或通用数据转换工具使用。
常见错误
- 提交的文本包含无法解析的 JSON 语法时会格式化失败。请根据解析错误详情检查引号、逗号和括号等位置,修正后重新提交;失败时提交的原文本仍会作为返回内容保留。
常见问题
可以把 JSON 压缩成紧凑格式吗?
可以。提交有效 JSON 后启用紧凑输出,结果会改用紧凑的逗号和冒号分隔方式,不采用缩进排版。
格式化后中文字符会保留吗?
可以。对于有效 JSON,格式化后的文本可以保留其中的中文等 Unicode 字符。
不输入内容会怎样?
如果输入框留空或只输入空白字符,工具会将其视为没有提供 JSON,返回成功状态但不生成格式化内容。