TSV 转 JSON 转换器
在浏览器中把 TSV 转换为 JSON,无需上传,无需注册。
深度指南
TSV 转 JSON:制表符分隔的解析、引号与粘贴的电子表格数据
本转换器如何读取制表符分隔的文本(仅制表符、首行为表头、识别 CSV 式引号、所有值为字符串),它与 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,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。
资料来源
- 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.
- IETF — RFC 4180, Common Format and MIME Type for CSV Files — The quoting convention this tool applies to tab-separated text as well.
- IETF — RFC 8259, The JSON Data Interchange Format
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。