差别就在「首行是否表头」那一个勾:勾上时每行出的是带列名的对象,不勾就是数组套数组;这一页在浏览器里跑完、能出八种形态(含 TSV、带 BOM 与不带 BOM 的 CSV),只吃纯文本、不解析 XLSX。

一、差别就在那一个勾:首行是否表头

先认两个格式名:CSV(Comma-Separated Values,逗号分隔值文本表)、JSON(一种以键值与数组组织数据的文本格式)。「CSV转换」 把一张纯文本表转成 JSON 时,「首行是否表头」这个勾选直接决定产物形态:勾上,第一行被当成列名,其后每一行都变成一个带列名的对象;不勾,就没有列名,整个表出成数组套数组的二维数组。这一步在浏览器里完成、文件不离开本机、不用登录。

二、两种形态分别长什么样、什么时候选

对象数组每行是「列名对应值」,读代码里按列名取值最省事,前提是表头确实规范、列名唯一。二维数组只保顺序不带名字,体积小、结构直白,适合列是固定的、程序按位置索引去取。对照下表,八种形态里最常用的几种各自怎么用。

选的形态产物长什么样什么时候用
JSON 对象数组每行一个带列名的对象勾了首行表头、给程序按列名取
JSON 二维数组数组套数组、没有列名没勾表头、只要按序的数据
TSV用制表符分隔的文本表要贴回表格软件继续排
带 BOM 的 CSV开头带标识字节让表格软件双击别按本地码解
不带 BOM 的 CSV纯 UTF-8、开头无标识字节给程序或网页读

三、编码、分隔符、引号这几个勾选一起看

这一页能勾的不止表头。分隔符会自动识别逗号、分号、Tab、竖线,也能手选——它按表头行里这几种符号各出现的次数来判,判错就在下拉里改成实际用的那个。编码可自动(识别 UTF-8、带 BOM 的 UTF-8、GBK)也可指定。引号规则按 RFC4180(CSV 引号规则的一份公开标准)处理,含逗号或换行的字段会被引号包起来。这些勾选影响的是产物结构,不涉及任何上传:全部在浏览器里算完。

四、只吃纯文本,XLSX 不在这页

「CSV转换」只吃 CSV、TSV、TXT 这类纯文本,不解析 XLSX(2007 及以上的表格文件格式)。要先把表格转成带列名的对象数组,正确顺序是:先用服务器端的 「CSV转Excel」 那条线处理表格文件(它只按逗号分隔解析、出一个工作表),产物再另存成纯文本后回到这一页转 JSON。要处理的是已经存好的纯文本表,才直接在这一页跑。两档分清楚:这一页是浏览器里完成、文件不离开本机、不用登录;「CSV转Excel」是把文件上传到本站服务器处理。

常见问题

问:表头行本身也想留成一行数据,怎么办?
答:那就不要勾「首行是否表头」。不勾时它按二维数组出,第一行也只是普通一行,不会被拿去当列名。

问:双击打开转出的 CSV 乱码,是转坏了吗?
答:不是。根因通常是导出成了不带 BOM 的 UTF-8,而表格软件按本地 GBK 去解——这里的 BOM 指文件开头那几个标识字节。正解是导出「带 BOM 的 CSV」形态,或在表格里用「从文本/CSV」导入、把原始格式选成 UTF-8。

问:这个转换要上传文件吗、手机上能做吗?
答:这一页不用上传,是纯前端,在浏览器里就地跑完、文件不离开本机、不用登录,手机浏览器打开也能用。只有「CSV转Excel」那条才要上传到本站服务器处理。

本站入口

这一步的主入口是站内 「JSON格式化」:把上一步出的 JSON 在浏览器里美化、校验或压缩,中文默认不转义,文件不上传。

拿到 JSON 后若要喂给程序,先跑一遍「校验」看有没有报错;要按列名取值就确认勾了首行表头、出的是对象数组。