用 split(',') 解析 CSV，为什么字段会错位？
不少同学处理 CSV 的第一反应是 line.split(',')，在小数据上能跑通，一遇到真实数据就错位。
原因在于 CSV 并非"按逗号切开"这么简单，RFC 4180 规定了完整的转义机制：
字段之间以逗号分隔，记录之间以换行分隔；
若字段值本身包含分隔符、双引号或换行符，整个字段必须用双引号包裹；
字段内部的双引号用两个连续双引号表示。也就是说 李四,30,"上海, 浦东" 里的第二个逗号属于字段内容而非分隔符，他说"今天天气不错" 在合法 CSV 中应写成 "他说""今天天气不错"""。
手写切分不处理这些规则，遇到带逗号的字段就会多出一列，后续所有字段整体右移。
第二个坑是类型推断。CSV 是纯文本、不带类型信息的格式，转换成 JSON 时通常会把纯数字转成 Number、"true"/"false" 转成 Boolean。这在统计类数据上很方便，但在编号类数据上是灾难：以 0 开头的编号 00123 前导零会消失，超过 2^53 的长整型会丢失精度，手机号虽然位数在安全范围内，一旦被当成数字，导出到 Excel 又会变成科学计数法。
第三个坑是编码。Excel 在 Windows 下默认按 ANSI（GBK）编码读取 CSV，而多数工具导出的是 UTF-8，直接双击打开就是一片乱码。理解这三点之后，下面以一个纯前端在线工具为例，演示完整的转换操作。
一、工具简介
盘子工具站的在线CSV与JSON转换（打开工具）是一个在浏览器本地完成表格数据与 JSON 数组互转的工具。核心能力：
- 本地处理：所有计算在浏览器完成，数据不上传服务器
- 双向转换：CSV → JSON、JSON → CSV 两个方向都支持
- 多分隔符 ：支持逗号
,、分号;、Tab 三种分隔符 - 正确转义：解析时正确处理引号内的分隔符、换行与转义引号；生成 CSV 时值中含分隔符、引号或换行会自动加引号转义
- 遵循 RFC 4180 ：按规范处理转义，避免手写切分导致的字段错位
二、适用场景
- 接口数据落地：把后台导出的 CSV 转成 JSON 数组，直接塞进前端 mock 或测试用例
- 表格数据入库：把 JSON 数组转成 CSV，交给运营在 Excel 里核对后再导入系统
- 日志与报表整理：服务端日志导出为 CSV 后，转成结构化 JSON 做二次统计
- 批量数据校对：分隔符不统一（逗号 / 分号 / Tab）的多来源文件，统一转换后再合并
三、操作步骤
第一步： 打开在线 工具地址，输入区自带一段示例：name/age/city 三列、4 条记录（张三 25 北京；李四 30 的 city 是含逗号的"上海, 浦东"；王五 28 的 city 是含双引号的他说"今天天气不错"；赵六的 age 为空、city 为杭州），可直接替换成自己的数据。
第二步： 在分隔符选项中选择逗号 ,、分号 ; 或 Tab，按文件实际情况来选。
第三步： 点击「转换」按钮，输出区显示"输出 JSON（4 条记录）"及转换结果，含分隔符与引号的字段会被还原成完整值。
第四步： 核对记录条数与字段值，特别是带引号、带换行和为空的字段是否与预期一致。
第五步： 点击输出区的「复制」取走结果，粘贴到代码或文件中使用。
第六步： 点击「清空」重置输入区与输出区，再开始下一批数据。
四、功能亮点
- 按规范转义：值包含分隔符时自动加引号，包含双引号时写成两个双引号，值为空时在两个分隔符之间留空
- 三种分隔符：逗号、分号、Tab 都能处理，欧洲区常见的分号分隔文件不再需要预处理
- 引号内换行支持：字段内的换行合法，不会被误判为记录结束
- 反向转换合并表头：JSON 转 CSV 时扫描整个数组，合并所有出现过的键作为表头，缺失的键留空
- 本地不上传：业务明细数据留在浏览器内，不必担心导出内容外泄
五、常见问题
Q：Excel 打开导出的 CSV 中文乱码？
Windows 版 Excel 默认按 ANSI（GBK）编码读取 CSV，而本工具导出的是 UTF-8，编码不匹配就会乱码。解决办法是用「数据 → 从文本/CSV 导入」并在导入向导中选择 UTF-8 编码，或先把后缀改成 .txt 再导入；macOS 版 Excel 一般能直接识别 UTF-8。
Q：JSON 转 CSV 时各行键不一致怎么办？
工具会扫描整个数组，合并所有出现过的键作为表头，某个对象缺失的键在对应单元格留空。需要注意两点：仅支持对象数组；嵌套对象和数组会被序列化为 JSON 字符串放入单元格，不会展开成多列。
Q：CSV 转 JSON 时数字会转为数字类型吗？
会。纯数字（含小数、负数）转 Number，"true"/"false" 转 Boolean，空字符串保持文本。如果手机号、以 0 开头的编号需要全部保留为字符串，需要自行处理或使用带引号的字段------引号包裹的值会被当作文本对待。
六、相关工具推荐
-
JSON格式化：转换结果的格式化与层级查看，便于核对嵌套结构
-
Mock随机数据生成：批量构造测试数据，可与 CSV 导入流程配合使用
七、总结
- CSV 的转义规则由 RFC 4180 定义，含分隔符、引号、换行的字段必须加引号，内部引号写成两个
- 手写
split(',')不处理转义，遇到带逗号的字段就会整体错位，规范解析是前提 - CSV 无类型信息，转换时的类型推断会让前导零消失、长整数失真，编号类字段应显式加引号
- Windows 版 Excel 默认按 GBK 读 CSV，UTF-8 文件应走「数据 → 从文本/CSV 导入」并选择 UTF-8