JSON 转 TSV 转换器

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

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

深度指南

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

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

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

关键数字一览

接受的输入
对象数组,或单个对象
标量、标量数组、数组的数组和含 null 的数组都会被拒绝。
分隔符
单元格之间用制表符,行之间用换行(LF)
不会添加末尾的换行。
来源: IANA — 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转回去,用 JSON 转 CSV写出逗号分隔的输出,用 JSON 验证器检查输入,或用 JSON 转文本查看数据中的路径。

常见问题

我的数据会被上传吗?

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

可以处理多大的文档?

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

嵌套数据会怎样处理?

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

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

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

资料来源

  1. IANA — Media type text/tab-separated-values — Lines, tab separators, header line; fields containing tabs are not allowable.
  2. IETF — RFC 4180, Common Format and MIME Type for CSV Files — The quoting convention this tool borrows.
  3. IETF — RFC 8259, The JSON Data Interchange Format

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

相关工具