JSON 转 CSV 转换器
在浏览器中把 JSON 转换为 CSV,无需上传,无需注册。
深度指南
JSON 转 CSV:列、嵌套值、引号与公式安全
转换器如何由对象数组生成表格:列的并集与顺序、嵌套值作为 JSON 文本、引号规则、LF 换行、哪些输入会被拒绝,以及它不防范的电子表格公式风险。
关键数字一览
- 接受的输入
- 对象数组,或单个对象
- 标量、标量数组、数组的数组和含 null 的数组都会被拒绝。
- 列
- 所有键的并集,按首次出现的顺序
- 缺少某个键的记录,该单元格为空。
- 嵌套值
- 以紧凑的 JSON 文本写入一个单元格
- 对象和数组不会被展开成额外的列。
输入与输出
粘贴 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,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。
资料来源
- IETF — RFC 4180, Common Format and MIME Type for CSV Files — Informational: fields, quoting, line breaks, header.
- IETF — RFC 8259, The JSON Data Interchange Format
- OWASP — CSV Injection — Cells starting with =, +, -, @, tab, CR or LF can be treated as formulas.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。