# JSON 转 TSV：制表符分隔的输出、引号与兼容性

> 转换器如何由 JSON 记录写出制表符分隔的文本：列的并集、嵌套值、哪些单元格会加引号（以及为何这超出了 IANA 的定义）、换行符，以及接收方无法读取引号时该怎么办。

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

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 接受的输入 | 对象数组，或单个对象 — 标量、标量数组、数组的数组和含 null 的数组都会被拒绝。 |  |
| 分隔符 | 单元格之间用制表符，行之间用换行（LF） — 不会添加末尾的换行。 | [IANA — text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) |
| 引号 | 仅当单元格含制表符、双引号或换行时 — 逗号和空格从不触发加引号。带引号的单元格采用 CSV 式的 " 加倍。 |  |
| 嵌套值 | 以紧凑的 JSON 文本写入一个单元格 — 因为 JSON 文本含双引号，这类单元格会加引号。 |  |

## 输入与输出

粘贴 JSON 后，右侧框显示制表符分隔的文本，并随输入实时更新。有输出时会出现下载链接（`converted.tsv`）；不会上传任何内容。你也可以复制结果并粘贴到电子表格中，电子表格通常会把每个以制表符分隔的值放进各自的单元格。

输入必须是对象数组或单个对象（只有一行）。第一行是表头。示例：`[{"name":"Mei","city":"Singapore","age":30},{"name":"Ali","city":"Johor","age":25}]` 得到如下结果，其中 `→` 表示制表符：

```
name→city→age
Mei→Singapore→30
Ali→Johor→25
```

其他输入（`5`、`"text"`、`null`、`[1,2]`、`[[1,2]]`、`[{"a":1},null]`）会中止并提示“只有对象数组（或单个对象）才能转换为表格。嵌套数组没有可以映射的行和列。”空数组得到空输出。

## 列与单元格的值

列是所有键的并集，按首次出现的顺序；缺少某个键的记录该单元格为空（`[{"a":1,"b":2},{"b":3,"c":4}]` 得到表头 `a→b→c`，随后是 `1→2→` 和 `→3→4`）。整数形式的键排在最前并按升序，因为 JavaScript 就是这样排列对象键的。

| JSON 值 | 单元格 |
| --- | --- |
| 字符串 | 文本本身 |
| 数字 | 按 JavaScript 方式输出（`1.50` 变成 `1.5`，`12345678901234567890` 变成 `12345678901234567000`） |
| `true` / `false` | `true` / `false` |
| `null` | 空单元格（与 `""` 相同） |
| 对象或数组 | 紧凑的 JSON 文本，如 `[1,2]` |

## 引号：本工具超出标准的地方

IANA 对 `text/tab-separated-values` 的登记规定：每条记录是一行，字段由制表符分隔，含制表符的字段不允许。它完全没有引号机制。本工具需要某种方式写出含制表符或换行的值，所以借用了 CSV 的约定：含制表符、双引号、换行（LF）或回车（CR）的单元格会用双引号括起来，内部的引号加倍。已核实的输出：

| 值 | 写出的单元格 |
| --- | --- |
| `has<TAB>tab` | `"has<TAB>tab"` |
| `say "hi"` | `"say ""hi"""` |
| `l1<newline>l2` | `"l1<newline>l2"` |
| `a,b` | `a,b`（逗号在 TSV 中无关紧要） |
| `  pad  ` | `  pad  `（不加引号） |
| 数组 `[1,2]` | `[1,2]`（内部没有双引号，所以不加引号） |
| 对象 `{"k":1}` | `"{""k"":1}"` |

含字符串的嵌套值，如 `["a","b"]`，含有双引号，所以写成 `"[""a"",""b""]"`。不理解引号的读取器会把这些引号原样显示出来。如果接收方是严格的 IANA 式 TSV 读取器，它也会被含制表符或换行的单元格搞糊涂；请先清理这些值，或改用其他格式。

换行符是 LF，末尾没有换行；非 ASCII 文本原样写出（文件为不带字节顺序标记的 UTF-8）。

## 公式安全

单元格按原样写出。以 `=`、`+`、`-` 或 `@` 开头的值，粘贴进电子表格时可能被当作公式（OWASP 称之为 CSV 注入，并且还列出了开头的制表符、回车和换行）。本工具不会处理它们。如果数据不可信，请自行清理这些值，同时接受数据因此被改变。

> **提示：** 当你的值里有很多逗号（地址、句子）而没有制表符时，优先选 TSV 而不是 CSV。几乎没有什么需要加引号，输出更易读，简单的拆分程序也能正常工作。

## 常见错误

- 期待字符串里写的 `\t` 显示为转义；值里真正的制表符会触发加引号。
- 输入嵌套数据却期待得到列；嵌套值仍是 JSON 文本。
- 丢失 `null` 与 `""` 的区别。
- 对含带引号单元格的输出直接用简单的 `split('\t')`。
- 传入的对象，其值才是记录；它只会变成一行。

## 相关工具

用 [TSV 转 JSON](https://toolsg.com/zh/tsv-to-json)转回去，用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)写出逗号分隔的输出，用 [JSON 验证器](https://toolsg.com/zh/json-validator)检查输入，或用 [JSON 转文本](https://toolsg.com/zh/json-to-text)查看数据中的路径。

## 常见问题

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

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

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

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

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

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

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

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


## 资料来源

- [IANA — Media type text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) — Lines, tab separators, header line; fields containing tabs are not allowable.
- [IETF — RFC 4180, Common Format and MIME Type for CSV Files](https://www.rfc-editor.org/rfc/rfc4180.html) — The quoting convention this tool borrows.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
