JSON 转 TSV 转换器
在浏览器中把 JSON 转换为 TSV,无需上传,无需注册。
深度指南
JSON 转 TSV:制表符分隔的输出、引号与兼容性
转换器如何由 JSON 记录写出制表符分隔的文本:列的并集、嵌套值、哪些单元格会加引号(以及为何这超出了 IANA 的定义)、换行符,以及接收方无法读取引号时该怎么办。
关键数字一览
- 接受的输入
- 对象数组,或单个对象
- 标量、标量数组、数组的数组和含 null 的数组都会被拒绝。
- 引号
- 仅当单元格含制表符、双引号或换行时
- 逗号和空格从不触发加引号。带引号的单元格采用 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转回去,用 JSON 转 CSV写出逗号分隔的输出,用 JSON 验证器检查输入,或用 JSON 转文本查看数据中的路径。
常见问题
我的数据会被上传吗?
不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备,不会被记录,也不会存储在服务器上。
可以处理多大的文档?
限制取决于您浏览器的内存,而非服务器配额。几兆字节的文档可以顺利转换;极大的文件可能会让页面在处理时短暂无响应。
嵌套数据会怎样处理?
对于没有嵌套概念的格式,嵌套值会以 JSON 字符串的形式存入单元格,因此不会有内容被悄悄丢弃,结构也可以还原。
能正确处理字段中的引号和逗号吗?
可以。解析遵循 RFC 4180,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。
资料来源
- IANA — Media type 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 — The quoting convention this tool borrows.
- IETF — RFC 8259, The JSON Data Interchange Format
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。