轻工具

CSV JSON 转换

CSV 与 JSON 双向互转：首行表头自动映射为 JSON 对象数组，或把对象数组还原为 CSV，支持分隔符自动识别、嵌套对象展平与 JSON 字符串化，全程在浏览器本地完成。

转换方向

第一行作为字段名，其后每行对应一个 JSON 对象。

使用说明

  1. 在顶部选择转换方向：CSV → JSON 或 JSON → CSV，输入框标签与提示会随之更新。
  2. 粘贴输入内容并选择分隔符（通常选「自动检测」即可识别逗号、分号或制表符）。
  3. CSV → JSON 时，第一行被当作字段名，其余每行转换成一个对象；JSON → CSV 时输入应为对象数组，首行表头由各对象键自动汇总。
  4. 遇到嵌套对象可选择「展平为点路径」或「JSON 字符串化」；数组等无法展平的值会以 JSON 字符串输出并给出提示。
  5. 点击「转换」查看结果，可用「复制」或「下载文件」保存；「示例」可快速载入演示数据。

常见问题

CSV 中的数字会转成 JSON 数字吗？
不会做类型推断：所有单元格都作为字符串输出，以保证来回转换不失真。若 JSON 侧确有数字字段，导出 CSV 时会原样保留其文本形式。
如何处理带引号或含分隔符的字段？
解析器遵循 CSV 常见规范：字段可被双引号包裹，内部的双引号用两个连续引号转义，分隔符与换行也可以出现在引号内；导出时也会按相同规则自动加引号。
JSON 里的嵌套对象与数组怎么转成 CSV？
展平模式下，嵌套对象会合并为点路径键（如 user.name）；数组无法用列表达，会以 JSON 字符串写入单元格并提示。字符串化模式则把所有对象与数组都写成 JSON 文本。
我的数据会上传到服务器吗？
不会。解析与生成全部在浏览器本地执行，输入内容不会离开当前设备，可放心处理敏感数据。

使用步骤

  1. 顶部选择转换方向

    在顶部方向里选好是要转成 JSON 还是转回 CSV，下方输入框的标签与提示会跟着变化，避免把数据贴错方向。

  2. 确认或设置分隔符

    通常保持自动检测即可识别逗号、分号或 Tab；遇到判断不准的文件再手动指定，保证列被正确切开。

  3. 决定嵌套对象处理方式

    JSON 转 CSV 遇到嵌套结构时可选两种处理。一是展平成点路径键名，如 user.name。二是整体转成 JSON 字符串。数组会以 JSON 字符串写入并给出提示。

  4. 点转换并检查结果

    点转换按钮生成结果：CSV 转 JSON 时首行作字段名、每行数据变一个对象；反向转换则从所有键推导表头。

  5. 复制结果或下载文件

    确认无误后点复制取走结果，或点下载文件保存成 CSV/JSON 文件；示例按钮可随时载入演示数据练手。

工具详细介绍

这是一款双向数据格式转换器：CSV 转 JSON 时把首行读作字段名，其余每行生成一个对象。JSON 数组也能压平回 CSV 表格。支持逗号、分号、Tab 分隔符自动检测，嵌套对象可展平为点路径或整体字符串化，全部解析与生成都在浏览器本地完成。

适合把 Excel 导出的 CSV 交给前端当测试数据，把接口返回的 JSON 整理成表格给同事看。在脚本和低代码平台之间搬运数据，也常用它做中转。批量调整表结构前，也可以先互转一遍核对格式。不做数字类型推断，所有单元格按字符串输出，来回转换内容零损失。

原理与背景

CSV 至今没有真正的官方标准：它从 1970 年代的大型机时代开始流通，RFC 4180 直到 2005 年才把约定固定下来。遗留分歧随处可见，欧洲版 Excel 因小数点是逗号而默认改用分号分隔，分隔符自动检测就是为这类文件准备的。RFC 4180 规定含逗号、双引号或换行的字段必须用双引号包裹、内部引号翻倍转义，但各软件对多行字段的支持并不一致。处理真实导出文件时要默认方言不纯，先小样本验证再放量。

所有单元格按字符串输出，规避的是两类经典事故。其一是类型误判：Excel 会把 1-2、3/4 之类的输入自动改成日期。2016 年人类基因命名委员会被迫改名 SEPT1 等一批基因符号，原因就是它们被 Excel 转成了日期。其二是精度：IEEE 754 双精度只有约 15 到 17 位有效数字，18 位身份证号、长订单号一旦转成数字就可能悄悄失真。保留字符串是稳妥做法，需要运算时再在下游显式转换。

典型使用场景

  1. 给前端准备测试数据

    把产品或运营给的 Excel 明细导出为 CSV，一键转成 JSON 数组即可充当 mock 数据。字段名与取值一目了然，后续改动也只需调整表格，不用重写结构。

  2. 把接口数据交给同事看

    接口返回的对象数组转成 CSV 后，运营与测试用表格软件就能按列筛选排序。嵌套字段展平成点路径列名后，数据来自哪一层一眼可辨，沟通成本立降。

  3. 跨平台搬运数据

    低代码平台、BI 工具与脚本之间倒数据时，CSV 是最通用的中间格式。先小批量转一次，核对列名、编码与分隔符，确认无误再放量，避免整批数据到对端才错位。

使用技巧

  • 工具不做数字类型推断：CSV 里的年龄、金额到 JSON 后仍是字符串，需要数字请在下游自行转换。
  • 字段含逗号或换行会被双引号包裹，内部引号按惯例翻倍转义，导出时同样自动加引号。
  • 反向转换要求输入是对象数组，表头由所有键合并而来；键不一致时自动补列，缺省留空。

注意事项

  • Excel 打开会改数据

    双击用 Excel 打开 CSV 再保存，数据就可能受损。长数字变科学计数法、前导零被删、日期被重排格式。只看不改也建议走导入向导，并把所有列设为文本。

  • 无 BOM 中文乱码

    Excel 直接打开无 BOM 的 UTF-8 文件会按本地编码猜测，中文整片变乱码。需要双击打开的文件应带 BOM 导出，程序之间互传则保持无 BOM，按用途选择。

  • 引号内的换行算数据

    字段双引号内部出现的换行属于数据本身，引号外的换行才是新记录。手工编辑时在引号里误按回车，一条记录会被拆成两条残缺数据，转换结果错位多半源于此。

相关工具