JSON 转 CSV 转换器

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

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

深度指南

JSON 转 CSV:列、嵌套值、引号与公式安全

转换器如何由对象数组生成表格:列的并集与顺序、嵌套值作为 JSON 文本、引号规则、LF 换行、哪些输入会被拒绝,以及它不防范的电子表格公式风险。

最后核实: 资料来源: IETF — RFC 4180 本指南的纯文本版

关键数字一览

接受的输入
对象数组,或单个对象
标量、标量数组、数组的数组和含 null 的数组都会被拒绝。
列
所有键的并集,按首次出现的顺序
缺少某个键的记录,该单元格为空。
嵌套值
以紧凑的 JSON 文本写入一个单元格
对象和数组不会被展开成额外的列。
换行符
LF,末尾没有换行
RFC 4180 规定用 CRLF;大多数工具读 LF 没有问题。
来源: IETF — RFC 4180

输入与输出

粘贴 JSON 后,右侧框显示 CSV,并随输入实时更新。有输出时会出现下载链接(converted.csv)。不会上传任何内容。

输入必须是对象数组,或单个对象(当作只有一行的表格)。输出的第一行是表头。示例:[{"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
[{"b":1,"2":2,"1":3}] 1,2,b / 3,2,1(整数形式的键排在最前)

因为 JavaScript 会把整数形式的键排在最前,所以 {"b":1,"2":2,"1":3} 这样的记录无论文本中顺序如何,都会读成 1, 2, b。{} 或 [{}] 只会得到一个换行。

单元格的值

JSON 值 单元格
字符串 文本本身
数字 按 JavaScript 方式输出:1.50 变成 1.5;12345678901234567890 变成 12345678901234567000;1e21 变成 1e+21;-0 变成 0
true / false true / false
null 空单元格(与 "" 无法区分)
对象或数组 带引号的紧凑 JSON 文本:[1,2] 变成 "[1,2]",{"k":"v,w"} 变成 "{""k"":""v,w""}"

看起来像数字的字符串("007")不带任何标记地写出,所以电子表格打开时可能把它变成数字 7。那是电子表格的行为,文件本身无法阻止。

引号规则

只有字段含逗号、双引号、换行(LF)或回车(CR)时才会加双引号,内部的引号会加倍,这与 RFC 4180 的要求一致。表头名称遵循同样的规则:键 a,b 变成 "a,b"。首尾空格不会加引号,所以 " pad " 直接写出;RFC 4180 把空格视为字段的一部分。非 ASCII 文本(é中🙂)原样写出,下载的文件是不带字节顺序标记的 UTF-8。

电子表格公式注入

值是原样写出的。以 =、+、- 或 @ 开头的单元格(例如 =SUM(A1))在电子表格看来就是公式,OWASP 把这称为 CSV 注入。本工具不会给这类单元格加前缀或做任何处理。如果数据来自不可信的用户,而 CSV 又会在电子表格中打开,请自行先处理这些值(例如加上单引号前缀),并注意这样会改变数据。

提示: 想把嵌套数据放进各列,请在转换前先展平,让 {"address":{"city":"SG"}} 变成 {"address_city":"SG"}。JSON 转文本能显示可作为列名的路径。

常见错误

  • 传入的对象,其值才是记录({"a":{…},"b":{…}}):它会变成一行带 JSON 文本单元格的数据,而不是每个条目一行。
  • 期待能区分 null 和 ""。
  • 在电子表格中打开含嵌套 JSON 单元格的 CSV,却期待得到分开的列。
  • 把输出当成严格符合 RFC 4180:它用的是 LF,不是 CRLF。

相关工具

用 CSV 转 JSON转回去,用 JSON 转 TSV生成制表符分隔的输出,用 JSON 验证器检查输入,或在 JSON 查看器中查看结构。

常见问题

我的数据会被上传吗?

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

可以处理多大的文档?

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

嵌套数据会怎样处理?

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

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

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

资料来源

  1. IETF — RFC 4180, Common Format and MIME Type for CSV Files — Informational: fields, quoting, line breaks, header.
  2. IETF — RFC 8259, The JSON Data Interchange Format
  3. OWASP — CSV Injection — Cells starting with =, +, -, @, tab, CR or LF can be treated as formulas.

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

相关工具