JSON / CSV 互转
在浏览器中把 JSON 与 CSV 互相转换,适合开发和数据整理。嵌套对象默认展平为点路径列名,嵌套数组默认写成 JSON 字符串;规则、示例和限制都写在本页,不会静默丢掉字段。文件只在本地处理。免费使用,无需注册。
转换工作区
隐私说明
解析和导出都在您的浏览器中完成。关闭或清空本页后,这次处理的文件会从本页释放。为统计与维护,在一次解析完成,或导出并生成下载后,网站会记录访问 IP、操作时间、处理数量(成功、失败、重复)以及导出格式,不记录文件名、键路径或文件内容。IP 不能代表您的身份,也不能用来联系您。这些记录最长保留约 90 天;如果日志占用空间超过上限,也可能提前清理较早的记录。数量由浏览器提交,仅供参考。打开本页和发送上述使用记录会访问本网站,但不上传这些 JSON 或 CSV。如果使用记录没有发送成功,不影响转换和下载。
拖入多个 .json、.jsonl、.ndjson 或 .csv,或点击选择(可多选)。有问题的文件会单独标为失败,不会拖累其他文件。
嵌套规则
这些规则会严格执行,不会为了“看起来成功”而丢掉字段。
- JSON→CSV 默认把对象或对象数组展平为表。嵌套对象用点路径做列名,例如 user.name。同一层有的对象缺某个键时,该单元格为空,该列仍保留。
- 嵌套数组默认序列化为 JSON 字符串写入一个单元格,例如 tags 列的 ["dev","数据"]。不会把数组元素拆成无名列,也不会丢弃该字段。
- 可选“展开为多行”:选定一个数组路径(如 items)后,一行会变成多行,父字段(如 id、user.name)重复,数组元素的字段出现在 items.sku 这样的列中。数组为空则仍输出一行父字段,展开列为空,并给出提示。路径不是数组,或数组里混合了对象与非对象,会拒绝并说明原因。
- 混合类型数组、顶层不是对象或对象数组(例如数字、字符串、[1,2,3])、循环引用、超出深度上限,会明确拒绝或降级并提示,不会假装转换成功。
- 键名本身含有点(.)或为空时无法安全做成点路径,该文件会失败并提示,而不是改名后悄悄继续。
- CSV→JSON 默认按点路径还原嵌套对象。也可勾选“保持扁平”,此时 user.name 仍是一个键名。若同一行既有 user 又有 user.name,会视为冲突并失败。
- 类型还原(写清以免误伤编号):空单元格 → 空字符串;单元格文本恰好为 null / true / false → 空值或布尔;不带前导零且在安全整数范围内的十进制数字 → 数字;以 0 开头的多位整数(如 00123)保持字符串;超过 JavaScript 安全整数的长整数保持字符串。若单元格是一段合法的 JSON 对象或数组文本,则还原为对象或数组,以便把默认写进单元格的嵌套数组转回去。
- 往返限制(诚实说明):展开多行后再转回 JSON,不一定等于原文。CSV 不能保留 JSON 的 undefined、注释,或键顺序之外的类型注释。JSON 的 null 会写成单元格文本 null;真正的空字符串导出后仍是空单元格,再转回是空字符串,因此空字符串与“无此键”在表里可能看起来一样。值为字符串 "null" 的单元格也会被当成空值。
示例(默认展平,不展开数组):
{
"id": 1,
"user": { "name": "Ada" },
"items": [{ "sku": "00123", "qty": 2 }]
}
会得到列 id、user.name、items,其中 items 单元格是 [{"sku":"00123","qty":2}]。若展开路径 items,则得到两列之外再加 items.sku、items.qty,sku 保持 00123。
范围与限制
- 一次最多 20 个文件;单个不超过 4 MB,合计不超过 16 MB。
- 嵌套深度最多 8 层;每列单元格最多 8000 个字符;单文件最多 200 列、20000 行,一批合计最多 50000 行。预览最多显示 30 行、20 列。
- CSV 分隔符和 GBK 编码必须手选,不会根据内容自动猜测,以免把编号或文本读错。
- 导出的 CSV 会把以 =、+、@ 或非纯数字的 - 开头的单元格按文本写出(前面加撇号),降低公式注入风险。这不是对所有电子表格软件的保证。
- 超过上限、坏 JSON、或无法按所选编码读取时,该文件会失败并显示原因。转换在本地后台线程中进行,可取消;处理过程中请不要关闭页面。
使用步骤
- 添加 JSON 或 CSV。读入 CSV 前请先选好分隔符和编码。失败的文件会单独标出,其他文件仍可使用。
- 查看预览中的行列与成功、失败计数。如需展开某个嵌套数组,勾选选项并选择路径。
- 选择导出 CSV、格式化 / 紧凑 JSON 或 JSON Lines,然后点击“转换并下载”。若当前条件无效,按钮会禁用;再次点击也会重新校验。多个结果会打包成一个 ZIP。
FAQ
会上传我的文件吗?
不会。解析和转换都在您的浏览器中完成。网站只在解析完成或导出后记录数量等基本使用信息,不记录文件名、键路径或内容。详见上面的隐私说明。
为什么不自动识别分隔符或 GBK?
自动猜测容易把编号、文本或字段边界读错。请手选逗号、分号或 Tab;需要 GBK 时再手动改编码。
展开多行后再转回,为什么和原来不一样?
展开是把一条记录拆成多行,转回时通常得到多条记录,或无法自动再收成原来的数组。这是已知限制,不是故障。若要更接近原文,请不要展开,让数组留在 JSON 字符串单元格中再转回。
这是表格合并拆分工具吗?
不是。本页只做 JSON 与 CSV 的互转。MindShift 目前没有单独的 JSON/CSV 互转桌面应用。Windows 上的 Spreadsheet Merge & Split 用于合并或拆分表格,不是本工具。
关于本工具
MindShift 目前没有单独的 JSON/CSV 互转桌面应用。本页也不是表格合并或拆分工具。可返回在线工具目录。