# TSV 转 JSON：制表符分隔的解析、引号与粘贴的电子表格数据

> 本转换器如何读取制表符分隔的文本（仅制表符、首行为表头、识别 CSV 式引号、所有值为字符串），它与 IANA text/tab-separated-values 定义有何不同，以及长短不一的行和空行如何处理。

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

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 分隔符 | 仅制表符 — 逗号和空格只是普通字符；字面上的反斜杠加 t 不会被转成制表符。 | [IANA — text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) |
| 表头行 | 始终是第一行 — 它的单元格成为 JSON 键；不能关闭表头。 |  |
| 值的类型 | 每个值都是字符串 — 30 变成 "30"，007 仍是 "007"。 |  |
| 引号 | 以 " 开头的字段按带引号字段读取 — 其中的制表符和换行会保留，"" 表示一个引号。IANA 登记并没有定义引号。 |  |

## 转换器做什么

粘贴制表符分隔的文本后，右侧框显示一个 JSON 数组，每个数据行对应一个对象，用两个空格缩进。它随输入实时更新，不会上传任何内容，有输出时会出现下载链接（`converted.json`）。这是从电子表格区域复制出来的数据的天然格式，因为电子表格程序通常在单元格之间放制表符、在行之间放换行；直接粘贴到左侧框即可。

示例输入（这里用 `→` 表示一个制表符）：

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

得到

```json
[
  { "name": "Mei", "city": "Singapore", "age": "30" },
  { "name": "Ali", "city": "Johor", "age": "25" }
]
```

值始终是字符串：是 `"30"`，不是 `30`。逗号、空格和分号在这里没有任何含义，所以 `1, 2` 仍是 `"1, 2"`。

## 标准里的 TSV 与本工具

IANA 对 `text/tab-separated-values` 的登记很简短：每条记录是一行，字段由制表符分隔，每条记录的字段数相同，第一行是各字段的名称，并且“含有制表符的字段在此编码中不允许”。它没有定义引号或转义，所以严格的读取器无法表示值中的制表符或换行。

本工具更宽容。它采用与 CSV 兄弟工具相同的引号处理（RFC 4180 的约定）：第一个字符是 `"` 的字段是带引号字段，其中的制表符和换行是字面内容，`""` 表示一个引号。因此 `"has<TAB>tab"` 变成单个值 `has\ttab`，`"two<newline>lines"` 变成两行的值。这对会加引号的工具所写的文件很有帮助，但也意味着恰好以双引号开头的普通值会被当作引号消耗；字段开头的游离引号如果没有闭合，则会提示“有一个带引号的字段没有闭合——请检查多余的双引号。”

字段中间的双引号保留为文本（`x"y` 仍是 `x"y`）。空格从不修剪。转义序列不会被解码：`\` 和 `t` 这两个字符保持原样。

## 行、表头与空行

| 输入 | 结果 |
| --- | --- |
| 单元格较少的行 | 缺少的单元格变成 `""` |
| 单元格比表头多的行 | 多余的单元格被静默丢弃 |
| 表头名称重复 | 后面的列生效 |
| 表头单元格为空 | 键为 `column_N`，N 为位置 |
| 行与行之间的空行 | 一条全为空字符串的记录 |
| 只有表头行 | `[]` |
| CRLF、CR 或 LF 换行 | 全部接受；末尾的一个换行被忽略 |
| 开头的 UTF-8 字节顺序标记 | 保留在第一个键的名称中 |

一行是 `x` 后面跟一个制表符（第二个单元格为空），得到 `{"a":"x","b":""}`；开头的制表符则得到空的第一个值。从电子表格粘贴时这一点很重要：末尾的空单元格会保留为空字符串，而不会被丢弃。

> **提示：** 如果电子表格单元格含有换行，请检查源数据是怎么写的。如果文本带引号到达，如 `"line1<newline>line2"`，本转换器会把换行保留在值里；没有引号的换行则会开启新的一行。

## 常见错误

- 粘贴逗号分隔的数据却只得到一个键：请使用 [CSV 转 JSON](https://toolsg.com/zh/csv-to-json)。
- 粘贴的文本被编辑器或聊天软件把制表符换成了空格；这样就没有制表符分隔符了。
- 期待得到数字、布尔值或 `null`。
- 值以双引号开头（如 `5"` 这样的尺寸），结果出现引号错误或文本被吞掉。
- 期待写成两个字符的 `\t` 变成制表符。

## 相关工具

用 [JSON 转 TSV](https://toolsg.com/zh/json-to-tsv)转回去，用 [CSV 转 JSON](https://toolsg.com/zh/csv-to-json)读取逗号分隔的文件，用 [JSON 验证器](https://toolsg.com/zh/json-validator)检查输出，或在 [JSON 查看器](https://toolsg.com/zh/json-viewer)中浏览。

## 常见问题

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

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

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

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

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

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

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

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


## 资料来源

- [IANA — Media type text/tab-separated-values](https://www.iana.org/assignments/media-types/text/tab-separated-values) — Records are lines, fields are separated by tabs, the first line names the fields, and 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 applies to tab-separated text as well.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
