文本与数据

JSON 转 CSV

将扁平 JSON 转为 CSV 表格,导入前先检查。

如何使用此工具

  1. 1

    粘贴有效的 JSON,内容应为扁平对象数组,或各行等长且只包含简单值的数组。

  2. 2

    选择逗号、制表符或分号作为分隔符,检查公式防护设置,并在 1 MB、10,000 行和 200 列的限制内转换。

  3. 3

    检查 CSV,尤其是空单元格和以公式字符开头的值,然后复制或下载。

将由扁平 JSON 记录组成的数组,或各行等长的矩形数组转为 CSV。工具会拒绝嵌套对象和数组,不会悄悄将它们展开。对于可能在电子表格中打开的导出文件,默认开启公式防护。

从适合表格的数据开始

扁平记录包含具名字段,其值可以放入单个单元格,例如名称、代码或数量。由这些记录组成的数组可以转换为表格。矩形数组则直接提供单元格数量相同的各行。由于这些结构的行列关系明确,因此工具支持它们。

记录中如果包含地址对象或标签数组,就是嵌套数据。本工具会拒绝嵌套值。转换前,请先决定如何将它们表示为列:地址可能需要拆成城市和邮政编码字段,标签列表也需要明确的表示方式。自动展平可能会掩盖这一步的重要选择。

示例:导出库存列表

假设扁平记录包含代码、名称和数量。请将 00127 这类产品代码保留为 JSON 字符串,使前导零仍存在于 CSV 文本中。“马克杯, 蓝色”这样的名称会放在带引号的 CSV 字段里,避免英文逗号分隔出额外的一列。

在电子表格中打开结果前,请通过导入选项把编码列设为文本。转换器可以保留 CSV 中的字符,但电子表格仍可能将其解释为数字。请检查导入后的编码,不要假定预览与电子表格中的显示始终一致。

理解公式保护

电子表格应用可能将某些开头字符解释为公式的起始符号。默认启用公式保护,有助于让这类导出单元格保持文本形式。当表格包含以 =、+、- 或 @ 等字符开头的值时,请检查此设置,尤其是在数据来自他人的情况下。

保护措施可能有意改变单元格在 CSV 中的表示形式。如果可信的下游系统需要完全一致的文本,请先检查输出并了解该系统的处理方式,再关闭保护。为包含逗号的 CSV 字段加引号是另一项操作;普通 CSV 引号本身并不能保证公式安全。

排查无效 JSON 和行长度不一致

JSON 的属性名和字符串值必须使用双引号。注释和末尾多余的逗号都不符合 JSON 语法。解析失败时,请检查工具报告的位置,修正输入后再试。从源代码复制的 JavaScript 对象不一定是有效的 JSON 文本。

对于二维行数组,每行必须包含相同数量的单元格。对于嵌套记录,请先在源系统中选出所需的列。导出内容须不超过 1 MB、10,000 行和 200 列,并保留原始 JSON,以便在导入 CSV 后对照检查。

保护长标识符和高精度小数

转换前会检查 JSON 数字。如果数值在 JavaScript 中表示时会发生变化、整数超出安全整数范围、发生溢出,或非零值会被舍入为零,工具就会拒绝转换。例如,要完整保留标识符 1234567890123456789 的每一位,应将它写成带引号的 JSON 字符串。对精度敏感的小数也应使用字符串。普通小数和科学计数法只要通过此检查、十进制数值不变,就可以使用。

常见问题

嵌套对象会被转为文本单元格吗?

不会。工具会拒绝嵌套对象和数组。请在转换前按需要自行展开数据,以便明确控制列名和值的含义。

CSV 会保留 JSON 类型吗?

CSV 是由文本字段组成的表格,无法保留完整的 JSON 类型定义。请确认接收应用在导入时如何解释数字、空单元格及其他值。

数据在哪里处理?

转换在浏览器中本地完成,不上传输入内容。离开页面前请下载或复制结果,并在导入完整表格前,在目标应用中检查一份样本。

参考资料与延伸阅读