CSV 转 JSON 转换器

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

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

深度指南

CSV 转 JSON:解析规则、字符串值与长短不一的行

本转换器如何读取 CSV(仅逗号、首行为表头、按 RFC 4180 处理引号并略有宽松),为什么每个值都是字符串,以及行过短、过长、表头重复和字节顺序标记时会怎样。

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

关键数字一览

分隔符
仅逗号
用分号分隔的文件不会被拆开;每一行成为一列。
来源: IETF — 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,因此包含逗号的带引号字段、转义的双引号,以及字段内部的换行都能被正确读写。

资料来源

  1. IETF — RFC 4180, Common Format and MIME Type for CSV Files — Informational (not a standard): fields, quoting rules, optional header.
  2. IETF — RFC 8259, The JSON Data Interchange Format — The JSON output.

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

相关工具