什么时候需要 JSON ↔ CSV
前端 Mock、接口数组要给运营用 Excel 打开；或同事发来 CSV，要变成 JSON 给程序读。ComTools 提供一对本地工具：
均在浏览器完成，适合中小表格快速转换。大文件 xlsx 请用 Excel 转 JSON / Excel 转 CSV。
JSON → CSV
规则
| 项 | 说明 |
|---|---|
| 输入 | 对象数组（以第一行对象的键为表头） |
| 输出 | 第一行列名，其后为数据行，逗号分隔 |
| 含逗号的值 | 自动加双引号，" → "" |
| 导出文件 | 「导出 CSV」会加 UTF-8 BOM，Excel 打开更不易乱码 |
空数组或不数组 → 空输出。
步骤
- 打开 JSON 转 CSV。
- 粘贴对象数组（可点示例）。
- 运行，预览 CSV 文本。
- 复制，或 导出 CSV 下载
data.csv。
示例
输入：
[
{"Id": 1, "Name": "Alice", "Email": "alice@example.com"},
{"Id": 2, "Name": "Bob", "Email": "bob@example.com"}
]
输出：
Id,Name,Email
1,Alice,alice@example.com
2,Bob,bob@example.com
CSV → JSON
规则
| 项 | 说明 |
|---|---|
| 第一行 | 表头（列名） |
| 其后行 | 数据，按逗号拆分 |
| 输出 | 格式化后的 JSON 对象数组 |
| 导入 | 可「导入 CSV」选择本地文件 |
解析为简单逗号拆分（适合常规表）；字段内复杂引号/换行建议先用 Excel 整理，或走 CSV 转 Excel。
步骤
- 打开 CSV 转 JSON。
- 粘贴 CSV，或导入
.csv文件。 - 运行，得到 JSON 数组。
- 复制 到代码或配置。
示例
输入：
Id,Name,Email
1,Alice,alice@example.com
2,Bob,bob@example.com
输出为带缩进的对象数组（字段均为字符串）。
常见场景
| 场景 | 方向 |
|---|---|
| 接口数组给业务用 Excel | JSON → CSV → 打开 / 转 Excel |
| CSV 名单变程序配置 | CSV → JSON |
| 再灌数据库 | JSON → 转 SQL 或 CSV → Excel 转 SQL |
| 只要某列 | 先转 CSV，或 JSONPath 取出后再处理 |
双向注意点
| 问题 | 建议 |
|---|---|
| 后续对象多出的键 | JSON→CSV 只认第一行对象的键 |
| 全部变成字符串 | CSV→JSON 不做类型推断；数字需程序里再 Number() |
| 嵌套对象/数组 | 扁平行结构才适合 CSV；嵌套请保持 JSON |
| 中文乱码 | 导出用带 BOM 的下载；导入确保源文件 UTF-8 |
相关工具
常见问题
Q：根是单个对象不是数组？
A：JSON→CSV 需要数组；可写成 [{...}] 再转。
Q：能选分隔符为 Tab 吗？
A：当前固定逗号；可用 文本格式化 事后替换。
Q：和 Excel 工具有何区别？
A：本对工具吃文本、全本地；Excel 工具适合上传工作簿、多 Sheet 与样式。