TSV 转 JSON 转换器

在浏览器中把 TSV 转换为 JSON,无需上传,无需注册。

所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。

深度指南

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

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

最后核实: 资料来源: IANA — text/tab-separated-values 本指南的纯文本版

关键数字一览

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

转换器做什么

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

示例输入(这里用 → 表示一个制表符):

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

得到

[
  { "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。
  • 粘贴的文本被编辑器或聊天软件把制表符换成了空格;这样就没有制表符分隔符了。
  • 期待得到数字、布尔值或 null。
  • 值以双引号开头(如 5" 这样的尺寸),结果出现引号错误或文本被吞掉。
  • 期待写成两个字符的 \t 变成制表符。

相关工具

用 JSON 转 TSV转回去,用 CSV 转 JSON读取逗号分隔的文件,用 JSON 验证器检查输出,或在 JSON 查看器中浏览。

常见问题

我的数据会被上传吗?

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

可以处理多大的文档?

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

嵌套数据会怎样处理?

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

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

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

资料来源

  1. IANA — Media type 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.
  2. IETF — RFC 4180, Common Format and MIME Type for CSV Files — The quoting convention this tool applies to tab-separated text as well.
  3. IETF — RFC 8259, The JSON Data Interchange Format

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

相关工具