把 CSV 转成 JSON,出问题时先看症状,再决定查哪一项。三种“看起来坏了”的情况,对应两类完全不同的故障:
- 整行数据被塞进一个值,JSON 里只剩一个键,值是一整行带分隔符的字符串;
- 表头不见了,第一行数据变成了键名,或者键名变成
column_1、column_2; - 中文变成
ä½ å¥½这类乱码。
前两种是字段边界问题:切分规则和文件实际格式对不上。第三种是文本编码问题:字节被按错误的字符集解码。这两类必须分开查——乱码时字段切分可能完全正确,错位时字符本身可能一个都没坏。修错位去改编码,通常只会让乱码换一种样子;看到乱码去改分隔符,也恢复不了字符。
下面按“先看什么、再改什么”的顺序排。
第一步:确认分隔符
CSV 名字叫“逗号分隔”,但现实中分号、Tab、竖线都很常见,尤其是从某些区域设置的系统导出的文件。
判断方法:用文本编辑器打开原文件,看第一行里数据之间夹的是什么字符。如果每个字段之间是 ;,而工具按逗号切,整行自然只会得到一个字段——这就是“整行进了一个字段”的典型来源。
在 CSV 转 JSON 转换器 里,分隔符可选自动、逗号、分号、Tab、竖线。自动模式在多数规整文件上够用,但遇到“数据里本身含逗号、真正分隔符是分号”的文件,自动判断可能选错。这时手动指定比反复重试有效。
第二步:确认首行是不是表头
如果 JSON 的键变成了 column_1、column_2,说明工具把第一行也当成了数据,按“无标题”模式生成了默认键名。
反过来,如果文件本来没有表头,却被当成有标题,第一行真实数据会消失,成为键名。两种情况都表现为“键不对”,处理方向相反:有表头就选“第一行为标题”,没有就选“无标题”。
判断依据还是看原文件第一行:它是字段名,还是一条正常记录。
第三步:检查带引号的逗号和换行
这是最容易被忽略的一类,也是“某一列之后整体右移”的常见原因。按 RFC 4180,字段里出现分隔符、换行或双引号时,整个字段要用双引号包起来,字段内的双引号写成两个。
例如:
name,note
张三,"喜欢咖啡,不加糖"
李四,"第一行
第二行"
"喜欢咖啡,不加糖" 里的逗号属于内容,不是分隔符;引号内的换行属于同一个字段,不是新记录。解析器不认引号规则,就会在这里多切一刀,导致这一行之后的列全部右移,或者一条记录被拆成两条。
同一个转换器页面使用本地打包的 Papa Parse(依据 Papa Parse 文档),能处理带引号的分隔符、换行和双引号。遇到未闭合引号、列数不齐、重复或空表头,会报错并阻止下载,而不是悄悄生成一份错位的 JSON。看到这类报错,先回原文件检查引号是否成对,比换工具更快。
第四步:编码只在乱码时查
编码问题的典型表现是:字段数量、键名都正常,只有中文或特殊符号显示成乱码。这时才需要动编码选项。
在同一个转换器里,文件默认按 UTF-8 读取,加载后可以改选 GBK/GB2312、GB18030、Big5、ISO-8859-1 并重新读取。国内不少旧系统导出的 CSV 是 GBK 系编码,用 UTF-8 打开就会乱码,换成 GBK 后通常恢复正常。
不同来源的文件编码情况复杂,不能假设所有编码组合都已逐一验证。如果换了几种编码仍是乱码,优先用编辑器确认文件真实编码,而不是继续在选项里碰运气。
一个可以对照的小例子
原文件 people.csv,UTF-8,逗号分隔,第一行为标题:
name,city,code
张三,北京,00123
李四,上海,00124
按“第一行为标题”、逗号分隔转换,预期 JSON 形如:
[
{ "name": "张三", "city": "北京", "code": "00123" },
{ "name": "李四", "city": "上海", "code": "00124" }
]
拿这份预期对照实际结果,注意每种症状对应的设置不同:
- 标题设置正确、分隔符选错时,键名会是
name,city,code这样的整行字符串,值也是整行——查分隔符; - 分隔符正确、但选成了“无标题”时,键名才会变成
column_1、column_2,第一行数据name,city,code被当作一条记录——查标题设置; - 键名和字段数都对,只有中文变成乱码,查编码。
注意 00123 在结果里仍是字符串,不是数字 123。单元格默认保留为字符串,空值和大整数也一样,这是为了避免前导零丢失和精度问题,不是转换出错。
常见误区
用 Excel 打开再另存为 CSV 来“修”文件。 这一步会改变分隔符、编码和引号规则,可能把原来的问题盖住,也可能引入新问题。排查阶段尽量保留原始文件。
看到乱码就去改分隔符。 乱码是解码问题,改分隔符不会让字符恢复,只会让字段切分也一起变乱。
忽略报错直接下载。 列数不齐、引号未闭合这类问题,工具会明确报错。报错指向的是原文件格式,不是工具故障。
操作顺序小结
- 打开原文件,看第一行用什么分隔、第一行是不是表头;
- 在转换器里手动指定分隔符和标题设置,重新转换;
- 仍有错位,检查字段内是否有未加引号的逗号或换行;
- 只有出现乱码时,才切换编码并重新读取;
- 转换后先看预览,确认键名和字段数,再下载
converted.json。
这个工具入口支持选择或拖放单个 .csv 文件,文件在浏览器本地读取处理。它不处理 .xlsx,也不做反向转换或自动嵌套对象,这些需求要另找路径。