CSV 转 JSON 指南：表头、分隔符、引号与数据类型处理

CSV 的隐藏规则

分隔符不总是逗号

本工具支持逗号 ,、分号 ;、制表符 Tab 和竖线 |。不同地区的 Excel 可能因为小数逗号设置而导出分号；复制网页表格常带 Tab。整份文件只能选一种主要分隔符，混用会造成列数漂移。

引号决定逗号是否属于内容

下面一行有三个字段，而不是四个：

id,name,note
1001,张三,"延迟 2 小时，已补发"

逗号出现在双引号内，属于 note 的内容。换行也可以出现在引号包裹的字段中。手工用 split(',') 解析往往会把它拆坏，本工具的逐行解析会处理常见的引号规则，但极端脏数据仍需专业 CSV 库复核。

表头是数据还是字段名

有表头时，第一行 id,name 变成对象键；没有表头时，转换器需要生成或使用默认列名。若误把第一条真实记录当表头，第一条数据就会丢失，且后面每个对象的键都会错位。

JSON 的结构代价

标准 JSON 的对象键必须用双引号，字符串也用双引号；数组用 []，对象用 {}。CSV 中所有单元格本质上都是文本，转为 JSON 时常见策略是：数字看起来像数字就转成数值，空字段变成空字符串或 null，布尔值是否转为 true/false 则取决于转换实现和约定。不要把转换器的推断当成业务类型定义。

二维 CSV 无法天然表示：

• 一个订单下有多个商品的数组；
• 客户地址中的国家、省、市层级；
• 同一字段既有数字又有带单位的文本；
• 原始列顺序之外的类型、约束、枚举和时区。

如果 JSON 里有嵌套对象，转回 CSV 时只能展平为列名（例如 address.city）或序列化成一个 JSON 字符串。回转后再转回 JSON，结构可能与原始对象不同。

WebUtils 操作流程

1. 打开 CSV 与 JSON 转换器，先判断左侧输入框放 CSV 还是 JSON。
2. 粘贴一小段真实结构的样例，不要一上来处理整份百万行数据。先验证列数、引号和编码。
3. 在分隔符下拉框选择逗号、分号、Tab 或竖线。复制自 Excel 的内容通常先试 Tab；看预览列数是否符合预期。
4. 根据第一行勾选或取消“包含表头”。有表头时，键名来自第一行；无表头时，确认页面生成的列名策略是否符合你的接口。
5. 需要阅读 JSON 时勾选“美化 JSON”；机器传输可关闭美化以减少体积。美化只改变空白，不改变数据语义。
6. 点击“CSV → JSON”，检查每个对象的键、值和行数；不要只看第一行。
7. 用一条包含逗号、引号、空字段和前导零的记录做边界测试，再复制或下载结果。
8. 反向转换时，把 JSON 放入 JSON 区，点击“JSON → CSV”，检查嵌套对象、数组和换行字段如何被展平。
9. 将结果交给 JSON 格式化或校验工具进行语法检查，再进入接口联调。

页面在浏览器本地执行，适合中小型文本。大文件会受到浏览器内存和文本框渲染限制，超过限制应改用命令行、脚本或数据处理平台。

真实输入输出：保留前导零

输入 CSV：

sku,qty,price,note
00123,2,9.90,"促销，第二件半价"
00007,,12.5,""

有表头且选择逗号后，理想的 JSON 结构可能是：

[
  {"sku":"00123","qty":2,"price":9.9,"note":"促销，第二件半价"},
  {"sku":"00007","qty":"","price":12.5,"note":""}
]

这里 sku 应保持字符串，否则 00123 会变成 123，库存系统就无法按原编号匹配。金额 9.90 变成数值后显示为 9.9，若财务要求两位小数，应在业务层使用定点金额或字符串，而不是依赖 JSON 展示格式。

类型与空值：转换后必须人工确认

建议在数据字典中写明“列名、是否必填、字符串/数字/布尔、空值含义、示例”。转换器负责语法层，数据字典负责业务层。

错误表：为什么结果会错位

发现行数不一致时，先统计原 CSV 的逻辑记录数，再统计 JSON 数组长度。含引号换行的记录不能简单按物理行数统计。

真实场景：从 Excel 到接口再回到报表

商品导入。 Excel 导出 Tab 分隔内容，SKU、条码和邮编必须保持字符串。先勾选表头、选 Tab，转换后抽查前导零，再用 JSON 校验器确认每个对象都有必需键。

日志分析。 日志字段中常含逗号和双引号，导出时选择逗号并正确转义。转换成 JSON 后按事件对象筛选，完成分析后只导出必要字段，避免把令牌和原始请求体带入报表。

接口回归测试。 用 CSV 保存几十组参数，再转换为 JSON 数组驱动测试。测试脚本要明确把 "001" 当字符串，把 1 当数字；不能依赖不同运行环境的自动推断。

财务对账。 JSON 的订单明细含数组，回导 CSV 时把商品数组展平为多行，并保留订单号。若强行一行一个订单，数组会被压成字符串，后续筛选和求和都不可靠。

供应商交换。 对方要求分号分隔且 UTF-8 BOM。转换器可验证字段结构，但文件编码、BOM 和换行风格要在最终导出脚本中明确处理。

安全与隐私边界

• 页面在浏览器中本地转换，不代表数据在电脑上没有痕迹；剪贴板、浏览器缓存、屏幕共享和下载目录仍可能泄露。
• 生产订单、客户手机号、访问令牌不应粘贴到公共演示或分享链接。先脱敏，完成后清空输入框。
• CSV 里以 =, +, -, @ 开头的单元格可能在电子表格中触发公式，导出给他人前要做 CSV 注入防护。
• 转换器不执行 JSON 中的脚本，但下游系统可能把字段当 HTML 或 SQL 使用，必须继续做输出编码和参数化查询。
• 大文件和高敏数据应在受控环境中用审计过的脚本处理，并保留输入哈希和输出版本。

相关工具选择

常见问题