CSV 转 JSON 转换器
在浏览器中把 CSV 转换为 JSON,无需上传,无需注册。
深度指南
CSV 转 JSON:解析规则、字符串值与长短不一的行
本转换器如何读取 CSV(仅逗号、首行为表头、按 RFC 4180 处理引号并略有宽松),为什么每个值都是字符串,以及行过短、过长、表头重复和字节顺序标记时会怎样。
关键数字一览
- 表头行
- 始终是第一行
- 它的单元格成为每条记录的 JSON 键;不能关闭表头。
- 值的类型
- 每个值都是字符串
- 30 变成 "30",007 仍是 "007",12.50 仍是 "12.50"。
- 带引号的字段
- 引号内的逗号、换行和 "" 都能正确读取
- 引号只在字段开头才会开启带引号字段。
转换器做什么
粘贴 CSV 后,右侧框显示一个 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":数字、布尔值和空单元格全部是字符串,因为 CSV 本身没有类型。所以前导零和末尾小数得以保留(007、12.50),1e3 或 0x1F 这样的值也不会被解释。需要数字时,请在你自己的代码里用 Number(value) 转换。
解析规则
RFC 4180 只是一份信息性备忘录,不是标准,现实中的文件常常偏离它。本解析器遵循其主要规则,并在几处更宽松:
- 记录以换行结束。CRLF、单独的 CR 和 LF 都接受;末尾的一个换行不会产生空行。引号内的换行会保留并规范成
\n。 - 只有字段的第一个字符是
"时才算带引号字段。引号内,""是一个字面引号,逗号和换行都是字面内容。 - 不带引号字段中间的引号会当作文本保留:
x"y得到x"y。RFC 4180 不允许这样,但很多导出程序会产生。 - 闭合引号之后的字符会被追加:
"x"y得到xy。 - 引号未闭合时转换会中止,并提示“有一个带引号的字段没有闭合——请检查多余的双引号。”
- 空格属于字段的一部分。
a, b得到键" b"," 1 "保留其空格;不做任何修剪。
长短不一的行、表头与空行
| 输入 | 结果 |
|---|---|
单元格较少的行(a,b 下一行 1) |
缺少的单元格变成 "" |
单元格较多的行(a,b 下的 1,2,3) |
多余的单元格被静默丢弃 |
重复的表头(a,a 下一行 1,2) |
后面的列覆盖前面的:{"a":"2"} |
空表头单元格(,b) |
键为 column_1(按位置) |
| 行与行之间的空行 | 一条值全为 "" 的记录 |
| 只有表头行 | [] |
| 开头的 UTF-8 字节顺序标记 | 会保留:第一个键变成 "name" |
| 用分号分隔的文件 | 只有一个键(a;b),整行内容是它的值 |
最后两行在实践中很重要。如果你的导出带字节顺序标记,粘贴前请先去掉,否则第一列的名称对不上。分号或制表符分隔的文件,请替换分隔符,或使用 TSV 转 JSON。
提示: 转换后,检查一行同一单元格里同时含逗号、引号和换行的记录。这一行能完整通过,其余的也不会有问题。
常见错误
- 期待数字或
null:得到的是字符串,空单元格是""。 - 粘贴的文件第一行是数据而不是表头;第一条记录会变成键。
- 没发现因为表头较短,多余的单元格被丢掉了。
- 依赖重复的列名;后面的会悄悄替换前面的。
- 以为页面会强制每行字段数相同。RFC 4180 要求每行字段数应当一致;本工具接受长短不一的行。
相关工具
用 JSON 转 CSV转回去,用 TSV 转 JSON读取制表符分隔的数据,用 JSON 验证器检查结果,或在 JSON 查看器中浏览。
常见问题
我的数据会被上传吗?
不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备,不会被记录,也不会存储在服务器上。
可以处理多大的文档?
限制取决于您浏览器的内存,而非服务器配额。几兆字节的文档可以顺利转换;极大的文件可能会让页面在处理时短暂无响应。
嵌套数据会怎样处理?
对于没有嵌套概念的格式,嵌套值会以 JSON 字符串的形式存入单元格,因此不会有内容被悄悄丢弃,结构也可以还原。
能正确处理字段中的引号和逗号吗?
可以。解析遵循 RFC 4180,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。
资料来源
- IETF — RFC 4180, Common Format and MIME Type for CSV Files — Informational (not a standard): fields, quoting rules, optional header.
- IETF — RFC 8259, The JSON Data Interchange Format — The JSON output.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。