JSON 格式化工具:检查语法、保留原始写法并浏览树视图
Admin ·
JSON 格式化应让数据更容易检查,同时避免悄悄替换大整数的数字或丢弃同名属性。ToolMellow 可格式化、压缩严格 JSON,保留源字面量写法,按需递归排序对象键,并在大纲限制允许时提供可搜索的树视图。
本指南说明怎样选择操作、定位语法错误、检查路径及导出完整结果,也解释原文保留的边界、重复键指针的歧义,以及输入、文件、树和历史各自的限制。处理在本机进行,无需账户。
格式化或压缩整个输入
将 JSON 放入「输入」,打开本地文本文件,或按「试用示例」。对象键默认「保持原顺序」。选择两个或四个空格,再按「格式化 JSON」获得可读缩进,或按「压缩」生成紧凑文本。两者先检查语法,再生成独立的只读「结果」;选中部分输入不会缩小处理范围。
编辑输入、更改缩进或键顺序,会清除旧结果并关闭原树视图。设置变动后请重新处理。「自动换行」仅改变长行的显示,不给 JSON 添加换行。界面语言改变控件文字,不翻译数据里的键和值;此工作区没有单独的文本语言选项。
- 编辑前先保留原始文档副本。
- 需要可读空白时用「格式化 JSON」,去除词元外空白时用「压缩」。
- 除非有意递归排序对象键,否则保持原顺序。
- 使用结果前,先阅读语法错误和重复键提示。
- 大纲可用时打开「查看 JSON 树」;树搜索与输入替换是不同控件。
- 复制或下载完整结果,再到接收数据的应用中核对。
严格 JSON 与 JavaScript 对象写法不同
输入必须包含一个完整 JSON 值。常见的是对象或数组,但字符串、数字、布尔值或 null 也可独立构成文档。对象名称和字符串值必须使用双引号。语法通过不代表满足必填字段、业务规则或 JSON Schema。
工具拒绝注释、末尾逗号和多余内容,不会自动修复。JavaScript 对象字面量、JSON5 或多条 JSON Lines 记录,应先进行适当转换。请明确修改原文;盲目删除标点、注释可能改变数据本意。
| 输入示例 | 这里是否接受? | 含义 |
|---|---|---|
{"ready":true} | 是 | 带双引号名称和布尔值的 JSON 对象。 |
[3,2,1] | 是 | 数组,元素顺序保持不变。 |
"hello", 42, true, null | 是 | 其中任意一个都可单独作为完整顶层值。 |
| 空编辑器或只有空白 | 否 | 其中没有 JSON 值。 |
{"a":1,} 或 [1,] | 否 | 末尾逗号会被拒绝。 |
{/* note */"a":1} | 否 | 注释会被拒绝。 |
{a:1}, {'a':1}, NaN, Infinity | 否 | 这些不属于这里接受的严格 JSON 语法。 |
{"a":1}
{"a":2} | 否 | 两条独立记录不是一份 JSON 文档。 |
从第一个错误位置检查原文
解析失败时,「结果」保持为空,并报告首个错误的行、列和原因。位置从一开始;列数按报错位置之前的 UTF-16 码元计算,不是屏幕格数或可见字符数。{
"a": } 中缺少值,报告位置为第 2 行、第 8 列。
检查该词元及其前面的标点,一次修正一处,再运行格式化或压缩。修复首个错误后,可能出现下一个错误。工具不会补入缺失值、猜测结构、一次列出所有错误或验证 Schema。
保留大整数与字符串的原始写法
结果由原始词元和空白编辑组成,不是把已解析的 JavaScript 数值重新序列化。大整数数字、指数写法、小数末尾零、负零及字符串转义写法都会保留。格式化调整词元外空白,压缩移除这些空白;字符串内部的空格仍属于字符串。
保留写法不保证接收程序的数值精度或范围。普通 JavaScript 数值未必精确保留超出其精确整数范围的每个整数,1e400 也可能超出接收方的有限数值范围。应选用接收系统支持的表示方式;工具不会自动将大数改成字符串。
| 源词元或属性 | 结果中保留什么 | 不保证什么 |
|---|---|---|
9007199254740993 | 原来的数字。 | 每个下游程序都能精确处理该数。 |
1e400 | 原来的指数词元。 | 采用 binary64 数值的接收方仍得到有限值。 |
1e+09 与 1.2300 | 原来的指数与小数写法。 | 统一为某一种规范表示。 |
-0 | 负号与零。 | 另一个序列化程序保留相同写法。 |
"\u0061" | 原来的字符串转义写法。 | 按解码值进行的树搜索会查找转义原文。 |
"a":1,"\u0061":2 | 两个属性及各自写法。 | 解码名称唯一或指针唯一。 |
RFC8259:JSON 语法、互操作及安全考量ECMAScript:JSON.parse 与 JavaScript 值转换
重复键会保留,仍需判断应保留哪个值
同一对象内重复的解码名称会触发重复键提示。工具保留每个属性,不丢弃较早的值。因此 "a" 与 "\u0061" 虽然源写法不同,却属于同一个解码名称。不同对象里的同名键,不会因此互相算作重复。
带提示的成功结果不等于已经修复。接收方对重复名称可能采用不同处理,包括只保留后面的值。使用前请确定原本想要哪个属性。树中会分行保留重复属性,但复制出的指针仍可能相同。
排序对象键,不排序数组元素
「保持原顺序」保留每个对象的属性序列。「升序」和「降序」递归按 UTF-16 字符串顺序比较解码后的键,不是按本地语言字母顺序或自然数值排序。例如升序中 "10" 位于 "2" 前,大小写也可能影响顺序。解码名称相同的转义与字面写法比较相等。
嵌套对象也会排序,包括数组里的对象;数组元素本身保持原顺序,解码名称相同的属性保留相对顺序。值和原始字面量写法不变。排序会改变输出字节,但不能因此将结果视为通用规范序列化或密码签名格式。
浏览有界树视图,同时保留完整文本
处理成功且大纲可用时,按「查看 JSON 树」。根最初展开,嵌套容器最初折叠。展开或折叠分支可检查子项;每个分支先显示最多 100 项,再用「显示接下来」追加一批。属性标签表示键,数组标签表示从零开始的下标。
数字和字符串叶节点显示原始写法,包括大数和转义。容器摘要显示子项数量。「隐藏 JSON 树」回到以文本为主的视图,不改结果。「重置树视图」清除树搜索并恢复初始分支状态。编辑输入会清除旧结果并关闭树视图;再次运行处理且成功后才会生成新结果。
谨慎复制路径,特别留意同名键
「复制指针」复制所显示节点的 JSON Pointer 路径。根显示为 $,实际指针却是空字符串。层级用 / 分隔;键中的字面波浪号写作 ~0,斜杠写作 ~1。数组下标从零开始。这些是指针,不是 JSONPath 表达式。
重复的解码键使多行拥有相同指针。按 JSON Pointer 规则,非唯一成员名称的求值未定义且会失败;复制路径不能唯一选中某次重复。工具仅显示、复制路径,不执行求值。剪贴板不可用时,可手动复制非根路径;根指针应使用空字符串,不要复制可见的根占位文字。
| 节点或键 | 指针示例 | 怎样理解 |
|---|---|---|
| 文档根 | 空字符串,这里用 "" 表示 | 复制零个字符,不是 $ 或引号。 |
根对象中的键 name | /name | 一级对象成员。 |
根对象中的键 a/b~c | /a~1b~0c | 名称内部的斜杠与波浪号已转义。 |
| 该数组键下的第一个元素 | /a~1b~0c/0 | 末尾零是数组下标。 |
根中两个解码为 a 的属性 | 两者均为 /a | 同名键使该指针有歧义。 |
搜索解码值与路径,不修改 JSON
树搜索以界面语言进行不区分大小写的子串匹配,检查键标签、指针路径及叶节点值。字符串先解码再搜索;数字和其他叶字面量按原文搜索。因此显示为 "\u0061" 的字符串可匹配 a,查找转义写法则是另一种操作。树搜索不修改源 JSON。
查询最多 1,000 个 UTF-16 码元。计数涵盖可用大纲中的匹配节点,列表只显示前 100 项。请细化过宽的查询,不要把可见列表当成全部命中。搜索结果中的容器也可能有子项控件。「重置树视图」清除查询。这是文本搜索,不是 JSONPath 或结构查询求值器。
分别看待输入、文件和树的限制
输入上限为含上限的 1,000,000 个 UTF-16 码元,不是字节数或可见字符数。基本多文种平面之外的一个 Unicode 码点占两个码元,表情序列可能占更多。另有 256 层嵌套限制。这些是接受边界,不保证边界内的每份文档在每台设备上都快速完成。
可选大纲另有预算。语法节点计数包含解析器的属性和键节点,不仅是可见行;只有一个标量属性的对象,已经有四个语法节点。重复的长键名、深路径也会耗尽文本预算。仅超出大纲预算时,完整格式化文本仍可使用并伴随提示,但其他处理限制仍适用。
| 边界 | 当前规则 | 实际影响 |
|---|---|---|
| 输入及解码后的导入文本 | 最多 1,000,000 个 UTF-16 码元。 | 恰好达到上限也接受;更长输入应拆分。 |
| 本地文件字节 | 严格少于 4,000,000 字节。 | 恰好 4,000,000 字节的文件也会被拒绝。 |
| JSON 嵌套 | 最多 256 层嵌套容器。 | 更深的 JSON 在格式化前被拒绝。 |
| 大纲语法节点 | 最多 10,000 个解析器语法节点。 | 不是允许 10,000 个属性。 |
| 大纲文本预算 | 标签、路径与叶字面量累计最多 2,000,000 个 UTF-16 单元。 | 树可能不提供,但结果仍完整。 |
| 每分支可见子项 | 先显示 100 项,再每批最多追加 100 项。 | 使用「显示接下来」查看更多。 |
| 树搜索 | 查询最多 1,000 个 UTF-16 单元;显示前 100 个匹配节点。 | 总匹配数可能超过可见列表。 |
| 输入撤销历史 | 最多 20 个旧快照,过去与未来状态合计 4,000,000 个 UTF-16 单元,不含当前输入。 | 旧历史可能丢弃,不是持久存储。 |
打开本地 UTF-8 文本文件
「打开文本文件」按 UTF-8 读取本地文件。先要求文件小于 4,000,000 字节,再检查解码文本是否符合输入上限。UTF-8 字节与 UTF-16 码元是两个独立指标,两项检查都会执行。选择器提供文本类文件类型,扩展名不能证明内容是有效 JSON。
导入将字面文本放入输入,不执行标记、不获取 URL,也不解析 PDF 或 Word。工具没有编码检测或其他解码选择。检查解码后的字符,再运行格式化或压缩。接受的导入进入输入历史;拒绝文件会保留原有输入。
复制、下载或复用完整结果
「复制结果」复制所有生成文本,不受当前选区或树搜索影响。剪贴板不可用时,可手动选取并复制结果。「下载」将完整结果写为 UTF-8 文本 toolmellow-result.json;导出的是生成文本,不是原始文件字节、截图或仅当前可见节点。
漂亮缩进可能使结果长于输入上限,复制和下载仍能导出完整结果。「将结果用作输入」单独检查上限,拒绝超过 1,000,000 个 UTF-16 单元的结果,并保留两个编辑器。允许复用时,会替换输入、清除旧结果;可在可用历史内撤销恢复先前输入。
使用字面替换与有界撤销
「在输入中查找和替换」独立于树搜索,在整个输入中查找字面文本,可选「区分大小写」,默认不区分。. 是普通查找文本,替换中的 $& 等美元序列也原样插入。查找字段最多 1,000 个 UTF-16 单元,替换字段最多 10,000。全部替换会拒绝导致输入超限的操作。
已接受的编辑、导入、替换和结果复用进入输入历史。撤销、重做恢复输入快照并清除旧结果;连续键入可合并。原生粘贴先减去被替换选区长度,并将 CRLF、CR 规范为 LF,再检查新长度;超限则整次拒绝。两种搜索都不理解 Schema,字符替换可能破坏 JSON 或改变值,修改后请重新处理。
了解清空、取消及本地处理
「清空」删除输入、结果、输入历史、查找替换字段并关闭树,保留缩进、对象键顺序、自动换行等设置。清空不可撤销。文本和结果仅在本标签页内存中,没有持久自动保存;刷新或离开前请导出副本。
处理在本地 worker 中进行。手动操作等待期间,「取消」停止当前操作并保留原输入;修改输入或选项也会使旧任务失效。worker 期限为包含启动时间的 60 秒,这是实现限制,不承诺所有支持的输入都能完成;失败时可尝试较小文档。
JSON 作为数据处理,树中的字符串、URL 以文本显示,不执行或获取。页面和处理资源仍可能发出网络请求。本地处理不是 JSON Schema 验证、秘密信息清除或内容安全判定;复制、下载后仍需检查数据要交给谁。
使用结果前,检查接收系统
检查数据时用可读格式,关心空白大小时用压缩;需要保留属性序列就保持原顺序,排序则应明确选择。原键顺序下,格式化采用被处理文本中第一个实际换行样式,没有换行才以 LF 兜底。排序先重建紧凑源文本,后续漂亮格式化使用 LF。外围空白会裁去。浏览器文本控件可能规范换行,因此工具不保留原文件的逐字节形式。
用于配置或 API 载荷前,处理重复名称提示,核对大数要求,并在接收系统中另行验证 Schema。可选树不可用时,使用文本结果。将重复键指针视为有歧义,清空、导航前保存。语法成功只说明 JSON 文本被接受,不证明其他应用接受其含义。
常见问题
大整数及数字写法会保留吗?
结果和树叶字面量保留原始数字词元,包括大整数、指数写法和负零;不保证接收应用的精度或范围。工具不会自动给大数加引号,也不统一其表示方式。
重复对象键会怎样?
所有属性都保留,并统计每个对象中重复的解码名称。字面名称 "a" 与转义名称 "\u0061" 解码相同。请自行处理非预期重复;接收程序可能只保留后面的值或作其他处理。
为什么重复键有相同 JSON 指针?
路径使用解码名称,因此同名键产生同一路径,不能唯一选中某次重复。RFC6901 规定非唯一成员的求值未定义且失败;此工具仅显示、复制路径。
接受注释、末尾逗号或 JSON Lines 吗?
不接受。注释、末尾逗号和额外记录会被拒绝。每次操作需要一个完整的严格 JSON 值;工具不转换或修复 JSON5、JSONC、NDJSON。
JSON 文档可以只有字符串、数字、布尔值或 null 吗?
可以。一个字符串、数字、true、false、null,以及对象或数组,都可构成完整 JSON 文档。空输入或只有空白时,没有 JSON 值。
排序对象键会改变数组顺序吗?
不会。排序按解码键的 UTF-16 比较递归调整对象属性;数组元素保持顺序,即使其中对象被排序,同名解码键也保留相对顺序。
为什么格式化成功,却没有树视图?
大纲最多 10,000 个语法节点,另有标签、路径和叶字面量累计 2,000,000 个 UTF-16 单元的预算,属性及键节点也计入。超出大纲预算可导致不提供树,同时仍保留完整文本和提示。
输入、文件和树有哪些限制?
输入和解码后的导入最多 1,000,000 个 UTF-16 单元,本地文件必须严格小于 4,000,000 字节。嵌套最多 256 层;树另有节点、文本预算及子项、搜索显示限制。这些边界不保证每台设备的完成时间或速度。
格式化会上传、执行或保存 JSON 吗?
JSON 在本地 worker 中处理,数据以文本显示。页面和资源仍可能通过网络加载。没有持久自动保存;清空删除文本和历史。工具不把 JSON 当代码运行,不清除秘密信息,也不证明内容适合其他系统。
格式化成功代表通过 JSON Schema 吗?
不代表。成功仅检查这里接受的 JSON 语法,不检查必填字段、应用类型、跨字段规则或 JSON Schema;这些要求应在接收系统中另行验证。
选中输入的一部分,只格式化选区吗?
不会。格式化和压缩处理整个输入,复制结果和下载也导出整个结果。树搜索改变可见搜索列表,不改变输出文本。
根 JSON 指针复制的是什么?
复制空字符串,可见根标签 $ 不是指针值。子路径用 / 分层,键中的波浪号转为 ~0,斜杠转为 ~1,数组使用从零开始的下标。
为什么能下载,却不能复用为输入?
漂亮格式可能使输出超过单独的 1,000,000 单元输入上限。完整复制、下载仍可用;将结果用作输入会拒绝超限结果并保留输入、输出。请导出或分段处理。
清空或刷新后能恢复文本吗?
清空删除输入历史且不可撤销。工作区没有持久自动保存或刷新恢复;清空、离开标签页前,请复制结果或下载副本。