# 把 JSON 当作树来读：查看器显示什么、隐藏什么

> 查看器如何把解析后的 JSON 变成可折叠的树，数组、空容器、字符串和数字如何显示，以及显示结果与源文本的差异。

- Tool: [JSON 查看器](https://toolsg.com/zh/json-viewer)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 树的来源 | 浏览器 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 转文本](https://toolsg.com/zh/json-to-text)把结构变成便于 grep 的 `路径 = 值` 行。遇到嵌套很深的文档，先“全部折叠”，再逐个分支展开。

> **提示：** 摘要里的数量是快速的合理性检查。如果某个 API 应该返回 50 项而数组显示 `[49]`，请先查明原因再往下看。

## 常见错误

- 把数组下的 `0`、`1`、`2` 当成数据的键。它们只是位置。
- 依赖树来确认源文件的精确数字或键顺序。
- 一次粘贴多个 JSON 文档（JSON Lines）；解析器会拒绝第一个之后的全部内容。
- 以为树能在编辑后保持原状：文本一变，折叠状态就重置。

## 相关工具

用 [JSON 验证器](https://toolsg.com/zh/json-validator)检查语法，用 [JSON 格式化](https://toolsg.com/zh/json-formatter)重新缩进，用 [JSON 转文本](https://toolsg.com/zh/json-to-text)展开路径，或用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)把对象数组变成行。

## 常见问题

**如何折叠 JSON 树的一部分？**

点击任意对象或数组即可折叠，也可以用“全部折叠”和“全部展开”一次调整整棵树。

**我的 JSON 会被发送到服务器吗？**

不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时，这一点尤为重要。

**为什么提示我的 JSON 无效？**

最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号，以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。

**它会改动我的数据吗？**

不会。文档会被解析并重新序列化，因此只有空白字符发生变化。键的顺序保持不变，值也不会被改动。

**能处理大型文档吗？**

可以，只要在浏览器内存允许的范围内。几兆字节的文档没有问题；极大的文件在解析时可能会让页面短暂停顿。


## 资料来源

- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — Object, array, string, number and literal value types.
- [MDN — The Details disclosure element](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/details) — The native expand and collapse behaviour the tree is built on.
