JSON 转 CSV 怎么做：先看数据结构再动手
JSON 转 CSV 怎么做，答案取决于你的数据是扁平结构还是嵌套结构。扁平数组可以直接映射成表格，嵌套对象需要先拍平或展开成多行。下面按数据结构、操作步骤、常见报错三条线讲清楚整个流程。
理解 JSON 转 CSV 是什么，是选择转换方式的前提。JSON 用键值对和数组描述层级关系，CSV 只用逗号分隔的二维行列，两者表达力不对等，所以转换过程一定伴随取舍。
JSON 转 CSV 是什么
JSON 转 CSV 是什么，可以拆成两句话理解：JSON 是带层级的文本格式，CSV 是纯二维表格格式；转换的本质是把层级压平成行与列。数组里每个对象通常变成一行，对象里的键变成表头。
需要留意的是，当对象里还有对象或数组时，压平方式不止一种。你可以把内层键拼成 user.name 这样的路径名，也可以把数组拆成多行重复外层字段。选哪种，取决于你后续要在表格里做什么统计。
动手前先判断你的 JSON 是哪种形状
打开文件先看最外层是什么符号，这一步能省掉后面大半的返工。
- 最外层是方括号
[：里面是对象数组，最理想的情况，可以直接转换。 - 最外层是花括号
{：先找到承载列表的那个键，比如data、items、records，用它的值作为转换对象。 - 字段里还有嵌套：先决定是拼路径名，还是把数组展开成多行，两种结果完全不同。
- 字段名不统一：不同对象出现的键不一样，缺失的键会留空，需要提前确认这是否符合预期。
判断形状这一步做完，后面九成的报错都能提前避免。
JSON 转 CSV 怎么做：分步操作
- 把原始 JSON 复制到文本编辑器中，确认编码是 UTF-8，避免中文变成乱码。
- 找到真正的数组层级，如果最外层是对象，先定位列表所在的键。
- 把 JSON 粘贴进转换工具的输入框，工具在浏览器本地解析，数据不会上传。
- 选择分隔符，默认逗号即可；如果字段内容本身含逗号，改用分号或用引号包裹。
- 选择嵌套字段的处理方式，拼路径名适合保留完整信息，展开成行适合做分组统计。
- 检查预览表头是否与预期一致，重点看有没有多出
0、1这类数组下标列。 - 导出 CSV，用表格软件打开，确认列数和行数与原始数组长度对得上。
在 浏览器本地转换工具 里执行以上步骤，全程不需要联网提交数据。
JSON 转 CSV 用不了：常见原因与排查
JSON 转 CSV 用不了，多数不是工具坏了，而是输入本身不满足转换条件。按下面顺序排查，基本能定位问题。
- 语法错误：多一个逗号、少一个引号、用了单引号代替双引号，解析器会直接拒绝。
- 最外层不是数组：很多工具只接受对象数组，遇到单个对象就报错，需要先包一层方括号。
- 数组里混了非对象元素：既有对象又有字符串或数字，表头无法统一。
- 字段数量差异过大：有的对象几十个键，有的只有一个，表头会被撑得很宽。
- 编码问题：文件带 BOM 或使用非 UTF-8 编码，中文会显示为乱码而不是报错。
如果确认输入合法仍然失败，把数据切出前 5 条单独试一次，能快速区分是数据问题还是体量问题。
JSON 转 CSV 大文件：体量与内存的处理
JSON 转 CSV 大文件最容易卡在内存上。浏览器方案要把整个文件读进内存再解析，文件越大占用越高，几百兆以上就可能让标签页失去响应。
处理思路有三条：一是先按时间或业务字段拆分源文件，分批转换再合并；二是删掉转换用不到的字段，减小体量；三是确认工具是否支持流式处理，不支持就避免一次喂入整个文件。
导出后的 CSV 同样要注意体量。部分表格软件对行数有上限，超出部分会被截断，转换前先估算行数。
JSON 转 CSV 和在线表格转换的区别
JSON 转 CSV 和在线表格转换的区别，主要在处理对象不同。前者面向开发者，输入是接口返回的原始文本，输出是给程序或数据分析用的文件；后者面向日常办公，输入输出都是已经排好版的表格文件。
具体差异体现在三点：转换方向是单向还是双向、能否保留表格里的公式与格式、是否需要理解数据结构。JSON 转 CSV 和在线表格转换的区别还在于容错策略，前者对语法错误零容忍，后者通常允许单元格内容随意填写。
接口调试 JSON 转 CSV：把响应变成可读表格
接口调试 JSON 转 CSV 是个高频场景。接口返回的响应体往往嵌套多层，直接看很难核对字段，转成表格后一眼就能发现哪个字段为空、哪个字段类型不对。
做法是复制响应体到工具输入框，重点确认列表所在的键。分页接口通常把数据放在 data.list 这类路径下，字段名带 id、name、created_at 的列要优先检查。接口调试 JSON 转 CSV 时如果发现某列整列空白，多半是字段路径选错了层级。
常见问题
字段里本身有逗号怎么办
用引号把该字段整体包裹，逗号就会被当作内容而不是分隔符。导出后用表格软件打开核对一列是否被拆成两列，是判断是否处理正确的直接方法。
嵌套对象转出来变成一长串怎么办
这是默认压平的结果，内层键被拼成了路径名。如果只想保留部分字段，转换前先删掉不需要的嵌套结构，表头会清爽很多。
中文显示乱码怎么解决
先确认源文件是 UTF-8 编码。如果源文件正常而导出后乱码，检查表格软件打开时是否选择了正确的编码，而不是用默认编码直接打开。
转换后行数比数组长度少
通常是有对象缺少关键字段被跳过，或工具默认去重。核对原始数组长度与导出行数，差值就是被丢弃的记录数。
能不能保留原始字段顺序
多数工具按首次出现的键顺序生成表头。如果顺序不符合预期，可以在源数据里统一键的排列，或转换后手动调整列顺序。
结尾
JSON 转 CSV 怎么做，核心就三步：判断数据形状、确定嵌套字段的处理方式、核对导出的行列是否与原始数据一致。先在小样本上跑通流程，再处理完整文件，能避开绝大多数返工。需要直接试的话，可以用 /tools/json-to-csv 在本地完成转换。