JSON 查看器
以可折叠的树形结构浏览 JSON,而不是面对一整片文本。
所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。
深度指南
把 JSON 当作树来读:查看器显示什么、隐藏什么
查看器如何把解析后的 JSON 变成可折叠的树,数组、空容器、字符串和数字如何显示,以及显示结果与源文本的差异。
关键数字一览
- 树的来源
- 浏览器 JSON.parse 返回的值
- 不是你粘贴的原始文本,所以键顺序和数字写法可能与原文不同。
- 节点标签
- 对象有 n 个键显示 {n},数组有 n 项显示 [n]
- 空容器显示 {0} 和 [0]。
- 数组位置
- 显示为 0、1、2 …(从 0 开始)
- 这些是索引,不是数据中的键。
- 初始状态
- 全部展开
- “全部展开”和“全部折叠”会一次切换所有节点。
你会看到什么
在左侧粘贴 JSON,右侧窗格会把它显示为一棵树。每个对象和数组都是原生 HTML 展开控件:点击其摘要行即可折叠或展开。摘要先显示键,再显示数量:对象用花括号(n: {3}),数组用方括号(tags: [2])。标量值在一行里显示为 键: 值。
初始时全部展开。全部展开和全部折叠会打开或关闭每个节点。编辑文本会从头重建整棵树,所以编辑之间不会记住折叠状态。查看器是只读的:没有搜索、没有复制路径、不能编辑,也没有输出框或下载。
输入无效时树会清空,并在输入框下方显示“JSON 无效:…”,浏览器提供位置时会带上行和列。输入为空时树会静默清空。
示例
粘贴 {"name":"Mei","tags":["a","b"],"n":{"x":1.50,"y":[],"z":{}},"ok":true,"v":null,"1":"one"} 得到如下的树(取自真实页面,窗格里靠缩进表示层级):
{6}
1: "one"
name: "Mei"
tags: [2]
0: "a"
1: "b"
n: {3}
x: 1.5
y: [0]
z: {0}
ok: true
v: null
请注意三点。键 "1" 虽然在文本里排最后,却出现在最前面。1.50 显示为 1.5。数组项标为 0 和 1,那是位置而不是数据。
树为什么会与原文不同
- 键顺序:JavaScript 对象先列出整数形式的键(升序),再列出其他键(按插入顺序)。因此用作键的 ID(
"10"、"2")会显示为2、10,排在名称之前。 - 重复键:只保留最后一个值,所以重复的键会在树中悄悄消失。RFC 8259 指出重复名称会让行为不可预测。
- 数字:按 JavaScript 的数字格式显示。
12345678901234567890显示为12345678901234567000,1e2显示为100,1e400显示为Infinity(解析时溢出)。 - 字符串:显示在双引号里,但不做转义。
"a\"b"显示为"a"b",字符串里的\n显示为普通空白,制表符显示为一段空隙。需要精确转义时,不要从树里复制值。 - 类型:字符串、数字、布尔值和
null颜色不同,但没有颜色时只能靠引号区分"1"和1。
浏览大型文档
树是一次性构建的:每个节点都会变成 HTML 元素,即使你之后把它折叠,也没有虚拟化。因此特别大的文档可能让标签页变慢或无响应。对于大文件,先提取相关部分,或用 JSON 转文本把结构变成便于 grep 的 路径 = 值 行。遇到嵌套很深的文档,先“全部折叠”,再逐个分支展开。
提示: 摘要里的数量是快速的合理性检查。如果某个 API 应该返回 50 项而数组显示
[49],请先查明原因再往下看。
常见错误
- 把数组下的
0、1、2当成数据的键。它们只是位置。 - 依赖树来确认源文件的精确数字或键顺序。
- 一次粘贴多个 JSON 文档(JSON Lines);解析器会拒绝第一个之后的全部内容。
- 以为树能在编辑后保持原状:文本一变,折叠状态就重置。
相关工具
用 JSON 验证器检查语法,用 JSON 格式化重新缩进,用 JSON 转文本展开路径,或用 JSON 转 CSV把对象数组变成行。
常见问题
如何折叠 JSON 树的一部分?
点击任意对象或数组即可折叠,也可以用“全部折叠”和“全部展开”一次调整整棵树。
我的 JSON 会被发送到服务器吗?
不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。
为什么提示我的 JSON 无效?
最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。
它会改动我的数据吗?
不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。
能处理大型文档吗?
可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。
资料来源
- IETF — RFC 8259, The JSON Data Interchange Format — Object, array, string, number and literal value types.
- MDN — The Details disclosure element — The native expand and collapse behaviour the tree is built on.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。