# JSON 转键路径文本：路径 = 值 的格式及其歧义

> 嵌套的 JSON 如何被展开成每个叶子值一行的“路径 = 值”，数组和空容器如何呈现，以及不同文档会产生相同行的情形。

- Tool: [JSON 转 纯文本 转换器](https://toolsg.com/zh/json-to-text)
- 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.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 行格式 | 路径 = 值，每个叶子值一行 — 对象的键用点连接；数组位置写成 [0]、[1] … |  |
| 空容器 | 写成 [] 或 {} — 其他行只为叶子值生成，所以空数组和空对象各占一行。 |  |
| 字符串 | 不带引号输出 — 因此字符串 "null" 与 null 值看起来一模一样。 |  |
| 下载 | converted.txt — 纯文本，内容与输出框完全一致。 |  |

## 工具输出什么

粘贴 JSON 后，右侧框会把每个叶子值（字符串、数字、布尔值或 null）各占一行，写成 `路径 = 值`。路径由上层的键构成：对象的键用 `.` 连接，数组项写成 `[索引]`，索引从 0 开始，括号前没有点。转换在浏览器里进行，随输入实时更新；有输出时会出现下载链接（`converted.txt`）。

示例输入：`{"user":{"name":"Mei","langs":["en","zh"],"address":{"city":"SG","unit":null},"empty":[],"none":{}},"ok":true,"n":1.50,"s":"null"}`

```
user.name = Mei
user.langs[0] = en
user.langs[1] = zh
user.address.city = SG
user.address.unit = null
user.empty = []
user.none = {}
ok = true
n = 1.5
s = null
```

这段文本也暴露了格式的局限：`1.50` 被输出为 `1.5`，而字符串 `"null"`（最后一行）与 `unit` 那行真正的 `null` 看起来完全相同。

## 数组根与标量根

顶层是数组时，每条路径都以索引开头：`[{"name":"Mei","age":30},{"name":"Ali","age":25}]` 变成 `[0].name = Mei`、`[0].age = 30`、`[1].name = Ali`、`[1].age = 25`。嵌套数组会连续写索引：`[[1,2],[3]]` 得到 `[0][0] = 1`、`[0][1] = 2`、`[1][0] = 3`。单独的标量如 `5` 或 `"hi"` 变成 `value = 5` 和 `value = hi`。顶层的 `[]` 或 `{}` 会写成带前导空格的 ` = []` 或 ` = {}`，因为路径为空。

## 输出在哪些地方有歧义

这种格式用于阅读、grep 和比对，而不是转换回 JSON。不同的文档可能产生完全相同的行：

| 输入 | 输出 | 问题 |
| --- | --- | --- |
| `{"a.b":1}` 与 `{"a":{"b":1}}` | 都是 `a.b = 1` | 键中的点没有转义 |
| `{"a[0]":1}` 与 `{"a":[1]}` | 都是 `a[0] = 1` | 键中的方括号没有转义 |
| `"null"` 与 `null` | 都是 `= null` | 字符串不带引号 |
| `"true"` 与 `true`，`"5"` 与 `5` | 相同 | 原因相同 |
| `{"a":"x = y"}` | `a = x = y` | 第一个 ` = ` 是分隔符，后面的属于值 |
| `{"a":"line1\nline2"}` | 两个物理行 | 字符串内的换行破坏了“一个叶子一行”的规则 |
| `{"":1}` | `value = 1` | 空键使路径为空，显示为 `value` |
| `{"a":{"":2}}` | `a. = 2` | 点后面是空键 |

字符串首尾的空格会原样保留，所以 `"  pad  "` 输出为 `a =   pad  `，空格很容易被忽略。

## 数字与顺序

值会经过 `JSON.parse`，所以数字是 JavaScript 双精度：`12345678901234567890` 输出为 `12345678901234567000`，`-0` 输出为 `0`，`1e400` 输出为 `Infinity`。整数形式的键会排在最前并按升序，其他键保持源文本顺序。重复键只保留最后一个值。

> **提示：** 想在大型响应里找到某个值的位置，把它转换后在输出里搜索该值即可。每个命中行都已带有完整路径，之后可以在 [JSON 查看器](https://toolsg.com/zh/json-viewer)里按路径定位。

## 常见错误

- 期望这是可逆格式。如果需要从这些行重建 JSON，请使用不会出现在键里的分隔符，或者保留原始文档。
- 把不带引号的 `null` 当成 JSON 的 null，而实际值可能是文本“null”。
- 把这些路径当成 JSONPath。JSONPath（RFC 9535）以 `$` 开头，对特殊键加引号，转义规则也不同。
- 一次输入 JSON Lines（多个文档）；解析器只接受一个 JSON 文本，会报错。

## 相关工具

用 [JSON 查看器](https://toolsg.com/zh/json-viewer)直观浏览结构，用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)或 [JSON 转 TSV](https://toolsg.com/zh/json-to-tsv)把记录数组展开为表格，并用[文本对比](https://toolsg.com/zh/text-diff)比较两份展开后的输出。

## 常见问题

**我的数据会被上传吗？**

不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备，不会被记录，也不会存储在服务器上。

**可以处理多大的文档？**

限制取决于您浏览器的内存，而非服务器配额。几兆字节的文档可以顺利转换；极大的文件可能会让页面在处理时短暂无响应。

**嵌套数据会怎样处理？**

对于没有嵌套概念的格式，嵌套值会以 JSON 字符串的形式存入单元格，因此不会有内容被悄悄丢弃，结构也可以还原。

**能正确处理字段中的引号和逗号吗？**

可以。解析遵循 RFC 4180，因此包含逗号的带引号字段、转义的双引号，以及字段内部的换行都能被正确读写。


## 资料来源

- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — The value types being flattened.
- [IETF — RFC 9535, JSONPath](https://www.rfc-editor.org/rfc/rfc9535.html) — A standard path syntax (for example $.user.langs[0]); this tool's paths are similar but not JSONPath.
