关于此工具
在日常数据分析、前后端联调及运营报表导出中,经常需要在树状结构的 JSON 对象数组与平面表格的 CSV(Comma-Separated Values,逗号分隔值,RFC 4180)之间进行数据迁移。JSON 适合程序解析传输,而 CSV 则是 Microsoft Excel、Google Sheets 及数据库数据导入导出的通用标准格式。本工具提供纯前端双向实时互转,支持嵌套字段展平(Flatten)、自定义分隔符、中文 UTF-8 BOM 防乱码及一键下载 `.csv` 文件。
如何使用本工具(操作步骤)
输入 JSON 数据或粘贴 CSV 内容
在左侧编辑框粘贴待转换的 JSON 对象数组(如 `[{"id": 1, "name": "Alice"}]`)或现有的 CSV 文本行。
选择转换方向与配置参数
点击切换「JSON 转 CSV」或「CSV 转 JSON」,并可配置是否展开多层嵌套对象(Flatten)以及字段分隔符(逗号或分号)。
复制结果或一键下载 CSV 文件
右侧即刻实时渲染转换结果,支持一键将文本复制到剪贴板,或直接导出带 UTF-8 BOM 的 `.csv` 文件用 Excel 打开。
支持复杂多层嵌套对象自动展平
遇到含有子对象(如 `user.address.city`)的复杂 JSON 时,自动将其转换为点路径列头,确保无损导出平铺表格。
自带 UTF-8 BOM,彻底解决 Excel 乱码
导出的 CSV 文件默认植入标准字节顺序标记(BOM),彻底解决 Windows 版 Excel 双击打开中文时常见的乱码痛点。
纯本地离线执行,商业数据零上传
所有行列解析与文件流装配均在本地浏览器内存中完成,财务流水、用户花名册等敏感数据绝无外泄风险。
CSV 格式标准规范与数据迁移避坑指南
- •Excel 打开大数字变成科学计数法(如身份证号):Excel 会自动将超过 11 位的纯数字视作科学计数法显示(如 `1.10101E+17`)并丢失末位精度。若字段为长数字,转换为 CSV 时建议加上制表符或以文本形式输出。
- •字段缺失时的补位空逗号:当 JSON 数组中某些对象缺少特定属性时,生成的 CSV 该行对应列必须保留逗号位置(如 `101,,开发`),以保持各行字段总数一致,否则解析器会串列。
- •避免公式注入风险(CSV Injection / Formula Injection):若导出的文本首字符包含 `=`, `+`, `-`, `@`,Excel 打开时会将其当作计算公式执行,甚至触发外部系统命令。涉及用户输入的文本需作转义处理。
代码与转换对比示例
JSON 对象数组转标准 CSV 表格对照示例
[
{ "id": 101, "name": "张三", "role": "开发", "city": "北京" },
{ "id": 102, "name": "李四", "role": "设计", "city": "上海" }
]id,name,role,city
101,张三,开发,北京
102,李四,设计,上海* 第一行为各对象的键名集合(Headers),后续每行为对应对象的属性值。
CSV 中包含逗号、换行与双引号的转义规范(RFC 4180)
字段值内含有逗号: "北京, 海淀"
字段值内含有双引号: Say "Hello"id,address,quote
1,"北京, 海淀","Say ""Hello"""* 字段内若有逗号必须用双引号整体包裹;内部的双引号必须用两个连续双引号("")进行转义。
常见问题解答
Q: 为什么用 Excel 打开 CSV 中文全是乱码?
A: 这是 Windows 平台 Excel 历史遗留问题。Windows 版 Excel 默认使用系统本地编码(如 GBK)打开无标记文件,当遇到 UTF-8 编码的纯文本时就会乱码。在文件开头加上 3 个字节的 UTF-8 BOM 标记(`\uFEFF`)即可让 Excel 自动识别为 UTF-8。
Q: 支持将包含子数组(Array)的 JSON 转成 CSV 吗?
A: 支持。对于数组类型的值(如 `tags: ["tech", "web"]`),系统会自动将其序列化为分号或逗号分隔的单格字符串(如 `"tech; web"`),确保在不破坏二维表格结构的前提下保留全部数据。
Q: 大体积 JSON(如几万条数据)转换会崩溃吗?
A: 本工具针对 V8 垃圾回收与字符串拼接进行了流式缓冲优化,轻松胜任几万行(几兆到几十兆)日常业务数据的瞬时转换。超百兆数据建议直接在服务器端用 Python 批量脚本处理。