CSV JSON 转换器

即时进行 CSV 与 JSON 格式互转。支持引号字段,第一行作为表头。免费在线工具,在浏览器中处理。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
CSV → JSON 时转换未加引号的 true、false、null 和符合 JSON 写法的数字。带引号的值、+81、007、.5、超过 2^53 − 1 的整数(含 1e21 这样的写法)以及 JavaScript 无法精确保存的数字保持为文本。更改此选项会重新转换当前 CSV。
CSV → JSON 时,将未加引号的空字段写成 null,而非空字符串。带引号的空字段仍是字符串。更改此选项会重新转换当前 CSV。
清空两个面板、状态和等待执行的转换,保留选项。焦点在工具内时,Ctrl+L(Mac 为 ⌘+L)也会清空。
粘贴以逗号分隔、带表头且至少有一行数据的 CSV。停止输入 0.3 秒后,JSON 会自动更新。支持引号字段中的逗号、换行和双写引号。
复制 CSV 面板内当前的全部文本,包括您编辑的内容。面板为空时无法复制。
粘贴非空的 JSON 对象数组。停止输入 0.3 秒后,CSV 会自动更新。嵌套对象展开为点路径列;数组和空对象写成 JSON 文本。
复制 JSON 面板内当前的全部文本,包括您编辑的内容。面板为空时无法复制。
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

从订单导出到 JSON

下面是一段常见的电商订单导出。订单号是 19 位,手机号是 11 位,第二行的金额带千分位逗号、加了引号:

订单号,收货人,手机号,金额,已付款
1830000000000000001,张伟,13800138000,128.50,TRUE
1830000000000000002,李娜,13912345678,"1,299.00",FALSE
[
  {
    "订单号": "1830000000000000001",
    "收货人": "张伟",
    "手机号": 13800138000,
    "金额": 128.5,
    "已付款": true
  },
  {
    "订单号": "1830000000000000002",
    "收货人": "李娜",
    "手机号": 13912345678,
    "金额": "1,299.00",
    "已付款": false
  }
]

逐项看结果:

  • 订单号超出 JavaScript 能精确表示的整数范围(2^53 − 1,约 9 千万亿),工具不把它转成数字,保留为字符串,19 位一位不少。写成指数形式的大整数也一样:1e21 保留为字符串 "1e21";长订单号如果已经被表格软件写成 1.83E+18,也保留为文本,不会变成看似完整的 1830000000000000000。
  • 手机号在安全范围内,又没有前导零,会变成 JSON 数字。接收方如果按字符串读取手机号,请取消勾选「推断数字和布尔值」,或在 CSV 里给这一列加引号。
  • 128.50 变成 128.5,末尾的 0 不保留;"1,299.00" 加了引号,原样保留为字符串。
  • TRUE、FALSE 不区分大小写,转成 JSON 的 true、false。

空字段转成 null

下面这份 CSV 里,Bob 没有 email,第 3 行没有 name。默认情况下空字段转成 "",勾选「空字段 → null」后:

id,name,email
1,Alice,alice@example.com
2,Bob,
3,,charlie@example.com
[
  {
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com"
  },
  {
    "id": 2,
    "name": "Bob",
    "email": null
  },
  {
    "id": 3,
    "name": null,
    "email": "charlie@example.com"
  }
]

加了引号的空字段("")不受这个选项影响,仍是空字符串。

全角逗号不是分隔符

用中文输入法录入时,很容易打出全角逗号:

姓名,部门
王芳,研发
[
  {
    "姓名,部门": "王芳,研发"
  }
]

整行成了一个键和一个值。分号、制表符同理:从表格软件里直接复制出来的单元格是制表符分隔的,也会变成一列。

JSON 转 CSV

后端接口返回的订单常带嵌套对象和数组。下面的订单号是 19 位的雪花算法 ID(MyBatis-Plus 的主键策略 IdType.ASSIGN_ID 默认用雪花算法生成 ID):

[
  { "订单号": 1830000000000000001, "收货人": "张伟", "收货地址": { "省": "浙江省", "市": "杭州市" }, "商品": ["键盘", "鼠标"] },
  { "订单号": 1830000000000000002, "收货人": "李娜", "收货地址": { "省": "广东省", "市": "深圳市" }, "商品": [] }
]
订单号,收货人,收货地址.省,收货地址.市,商品
1830000000000000001,张伟,浙江省,杭州市,"[""键盘"",""鼠标""]"
1830000000000000002,李娜,广东省,深圳市,[]

嵌套的收货地址展开成 收货地址.省、收货地址.市 两列(与 pandas json_normalize 的列名规则相同),数组写成 JSON 文本,字段里的双引号按 CSV 规则写成两个。

两行的订单号都超过了 2^53 − 1。浏览器自带的 JSON.parse 会把它们舍入成同一个 1830000000000000000;本工具在支持 JSON.rawJSON 的浏览器(Chrome 114、Firefox 135、Safari 18.4 及以后)里按 JSON 原文写出,所以 CSV 里仍是两个不同的订单号。更旧的浏览器会把这类数字按文本写出(数组单元格里会带引号),并在状态栏列出这些数字,不会写出舍入后的值。

支持的 CSV 格式

本工具遵循 RFC 4180 的引号规则:字段以逗号分隔;字段里有逗号、换行或双引号时,要用双引号包住整个字段,字段内的双引号写成两个("")。第一行固定当作表头;表头重名时依次加 _2、_3,超出表头的字段用 column_N 作键,两种情况都会在状态栏说明。

限制

  • 只认半角逗号。 制表符、分号、全角逗号都不是分隔符。
  • 只有字段开头的双引号算引号。 没加引号的字段里出现的 " 是普通字符,5" 管,x 就是 5" 管 和 x 两个字段。引号字段一直没有闭合时,转换会停止并报出引号开始的行号,JSON 面板保持为空:
商品,价格
"无线鼠标,99
键盘,199

状态栏显示 错误:第 2 行开始的引号字段没有闭合。请补上结尾的 ",或删掉开头的 "。

  • 只有 JSON 写法的数字才转成数字。 按 RFC 8259 第 6 节的数字语法(可带负号、不能有前导零和 +、小数点两边都要有数字),而且 JavaScript 的数字能原样保存时才转换。电话区号就是常见的例子:
地区,区号
中国大陆,+86
香港,+852
[
  {
    "地区": "中国大陆",
    "区号": "+86"
  },
  {
    "地区": "香港",
    "区号": "+852"
  }
]

+86 不是 JSON 数字写法,保持字符串。同理,.5、-0、会下溢成 0 的 1e-400 和有效数字太多的长小数也都保留原文。

  • 大数字按原文写出,见上面的订单号示例;1e-400、-0 这类 JavaScript 无法原样保留的数字也一样。JavaScript 能精确保存的数字则按 JavaScript 的写法写出(ECMA-262 Number::toString):128.50 写成 128.5,1e21 写成 1e+21。把这份 CSV 再转回 JSON,得到 128.5 和字符串 "1e+21",因为超过 2^53 − 1 的整数保持为文本:
[{ "金额": 128.50, "浏览量": 1e21 }]
金额,浏览量
128.5,1e+21
  • 表头里的空格会留在键名里。 RFC 4180 第 2 节把空格算作字段的一部分,所以 姓名, 城市 的第二个键是 " 城市",值 " 北京" 也带着空格。开头或结尾有空白(含全角空格)的表头名会列在状态栏里;不需要这些空格时,请在源数据里删掉:
姓名, 城市
张三, 北京
[
  {
    "姓名": "张三",
    " 城市": " 北京"
  }
]

状态栏显示 已将 1 行转换为 JSON。 这些表头名开头或结尾有空白,空白会留在键名里:" 城市"。

  • 键的顺序。 像整数的键(如 2023)会排在其他键前面,两个方向都是这样,值本身不受影响。
  • 不处理编码。 工具只处理粘贴进来的文本。用 GBK 等编码保存的 CSV,如果在编辑器里打开时已经是乱码,粘贴进来仍是乱码,请先用正确的编码打开文件。
  • JSON 语法错误会停止转换并清空 CSV 面板,状态栏写出出错的行、列和原因,行列从 JSON 面板开头算起。例如键名后面混入了全角冒号:
[{"姓名":"张三","城市":"北京"}]

状态栏显示 这不是有效的 JSON:第 1 行第 7 列,全角字符 :;JSON 的标点和空格必须是半角。

FAQ

支持什么 CSV 格式?

逗号分隔、按 RFC 4180 规则加引号的 CSV:用双引号包住的字段里可以有逗号、换行和两个连写的双引号("")。行尾可以是 LF、CRLF 或 CR。只有半角逗号是分隔符,制表符和分号都算字段内容。

表头如何处理?

第一行始终作为表头,之后每一行转成一个以表头为键的 JSON 对象。不会丢值:重名的表头依次改成 _2、_3(如 sku、sku_2),超出表头的字段按位置用 column_N 作键,状态栏会列出这两类改动;字段不够的行按空值补齐。表头名前后的空格也会留在键名里(RFC 4180 把空格算作字段的一部分),如 name, age 的第二个键是 " age",状态栏会列出这类表头。

能把 JSON 转回 CSV 吗?

能。在 JSON 面板粘贴对象数组即可。列取所有对象里出现过的键,按首次出现的顺序排列;嵌套对象展开成 收货地址.省 这样的点路径列,数组和空对象写成 JSON 文本,null 写成空字段。再把这份 CSV 转回 JSON 时不会还原嵌套。

有大小限制吗?

代码里没有设上限。每次停止输入 0.3 秒,工具都会把全部文本重新转换一遍,所以粘贴的内容很大时页面会变慢。工具只处理粘贴的文本,不打开文件。

中文输入法打出的全角逗号能当分隔符吗?

不能。只有半角逗号(,)是分隔符,全角逗号(,)和顿号(、)都算字段内容,整行会变成一个字段。转换前先把全角逗号替换成半角逗号,或切换到英文标点再输入。

数据会发送到服务器吗?

不会。两个方向的转换都在浏览器标签页里完成,CSV 和 JSON 不会发送到服务器,也不会保存到浏览器存储。本工具不发送使用事件,页面的统计只记录这次页面浏览。