JSON转CSV格式转换的核心思路是解析JSON结构并将其扁平化为表格，常见方法包括使用在线工具、Python脚本或命令行工具，具体选择取决于数据复杂度与处理场景。
JSON与CSV格式的本质差异
在动手转换之前，有必要先搞清楚这两种数据格式的底层逻辑，JSON使用键值对和嵌套结构，支持对象、数组、字符串、数字等丰富类型，适合存储层次化数据，CSV则是纯表格结构，每行对应一条记录，列与列之间用逗号分隔,无法直接表达层级关系。
适用场景对比
- JSON：API接口返回、配置文件、复杂对象序列化,数据之间常有父子关系。
- CSV：Excel导入导出、数据库导入、数据分析工具输入,要求数据规整无嵌套。
行业共识认为，当数据量较大且需要人工干预时，CSV格式更友好；而自动化流程中JSON更为灵活,理解这个差异能帮你判断转换时需要做哪些预处理。
转换前的数据评估
多数情况下,你会遇到三种JSON结构：
- 纯数组对象：如
[{"id":1,"name":"A"},{"id":2,"name":"B"}],直接映射为CSV行列。 - 嵌套对象：如
{"data":[{"id":1,"info":{"name":"A"}}]},需要先提取路径。 - 深层嵌套或数组内数组：需要递归扁平化,否则CSV会丢失信息。
在我处理过的案例中，大约六成以上的转换问题都源于对嵌套结构处理不当，第一步是打开JSON文件,用肉眼或工具确认其深度。
主流转换方法实操对比
当前市面上有三大类转换途径，各有优劣，下面从操作门槛、处理能力、批量性能三个维度进行对比。
| 方法 | 操作门槛 | 嵌套处理能力 | 批量处理速度 |
|---|---|---|---|
| 在线转换工具 | 极低，无需安装 | 较差，仅支持简单结构 | 中等，受限于上传带宽 |
| Python脚本（pandas） | 中等，需编程基础 | 强，可自定义扁平化逻辑 | 快，适合大文件 |
| 命令行工具（jq+csvkit） | 较高，需熟悉命令 | 较强，但语法复杂 | 极快，适合服务器环境 |
json转csv在线工具的选择
如果你只需要偶尔处理几个小文件，在线工具是最快捷的，搜索时可能会遇到 “json转csv在线工具” 这类长尾词,我建议你关注以下几点：
- 是否支持文件上传：有的工具只支持粘贴文本,超过1MB就容易卡顿。
- 是否保留所有字段：有些工具会忽略空值或深层键,导致数据丢失。
- 隐私安全：避免上传包含敏感信息的JSON到不明网站。
实际操作时，你可以先截取一小段JSON测试,确认输出符合预期后再处理完整文件。
用Python脚本实现json转csv
对于需要频繁转换或处理复杂结构的场景，写一个Python脚本是性价比最高的方案,以下是一个基于pandas的典型步骤：
- 安装依赖：
pip install pandas - 读取JSON：
df = pd.read_json('input.json') - 处理嵌套：使用
pd.json_normalize()将嵌套对象展开 - 写出CSV：
df.to_csv('output.csv', index=False)
这里的关键是 json_normalize 函数，它会把嵌套字典中的键用点号或下划线连接成扁平列名。info.name 变成一列，如果遇到了数组嵌套,则需要先展开循环。
大多数情况下，这套流程能覆盖九成以上的转换需求，如果你需要更精细的控制，可以改用 json 模块逐行解析，逐行写入CSV,这样能处理超大文件而避免内存溢出。
命令行工具组合拳
在服务器或Linux环境下，一条命令就能完成转换，比如用 jq 将JSON转为csv：
jq -r '.[] | [.id, .name] | @csv' input.json > output.csv这条命令把数组中的每个对象提取出id和name字段，并以CSV格式输出，如果字段较多，可以手动列出；如果字段动态变化，则需要结合 keys 和循环，对于更复杂的场景，csvkit 里的 in2csv 工具也能直接读取JSON,但它的扁平化能力有限。
处理嵌套JSON的转换技巧
嵌套结构是json转csv过程中最常见的痛点，如果在百度搜索“json转csv嵌套”，你会发现大量求助帖,下面我拆解两种典型情况。
单一嵌套对象
假设你的JSON长这样：
{
"students": [
{"name": "张三", "score": {"math": 90, "english": 85}},
{"name": "李四", "score": {"math": 88, "english": 92}}
]
}
期望的CSV应为三列：name, math, english，使用pandas的 json_normalize 时，指定参数 record_path='students' 和 meta=[],它会自动将score内的键作为列。
数组内嵌数组
当JSON中包含数组内的数组时，比如每个学生有多门课程,且课程是数组：
{
"students": [
{"name": "张三", "courses": [{"course":"数学","grade":90},{"course":"英语","grade":85}]}
]
}
这种情况下，直接扁平化会丢失一对多关系，通常的做法是拆行：每个课程占一行，学生信息重复，这需要先用 json_normalize 展开courses，再通过 explode 或循环实现。
如果你使用的在线工具无法处理这种结构，建议转用Python脚本，不少“json转csv格式转换步骤”的文章会强调手动编写递归函数，但实际工作中我更推荐pandas内置方法,因为它已经处理了大多数边界情况。
批量转换与自动化流程
当你需要处理大量JSON文件，比如每天导出的日志或API响应，批量转换就成了刚需，搜索“json转csv批量”的用户往往在寻找脚本或工具。
文件夹批量处理脚本
以下是一个Python脚本骨架,可以递归处理指定目录下所有json文件：
import pandas as pd
import glob
import os
input_dir = 'json_files/'
output_dir = 'csv_files/'
os.makedirs(output_dir, exist_ok=True)
for filepath in glob.glob(input_dir + '.json'):
data = pd.read_json(filepath)
# 如果有嵌套，用json_normalize处理
data = pd.json_normalize(data.to_dict('records'))
filename = os.path.basename(filepath).replace('.json', '.csv')
data.to_csv(os.path.join(output_dir, filename), index=False)
这个脚本将每个JSON文件转换为独立的CSV文件，如果你希望合并所有文件为一张大表,可以在循环中追加写入。
定时任务自动化
在Linux服务器上，可以用cron设置每天凌晨执行上述脚本；在Windows上，可以用任务计划程序调用Python脚本，对于非技术人员，可以借助一些低代码工具，比如在Excel里用Power Query获取JSON并定时刷新,但稳定性不如脚本。
有个细节值得注意：批处理时，不同JSON文件的字段可能不一致，建议统一提取所有出现的键，缺失的列填充空值,否则合并后的CSV会出现列错位。
json转csv格式常见问题解答
转换后CSV中数据错乱或丢失怎么办？
首先检查源JSON的编码，确保是UTF-8，如果文件中有特殊字符（如换行符、逗号），CSV解析时会串列，解决办法是在输出时对字段加引号，并设置 quoting=csv.QUOTE_ALL，对于嵌套结构，确认是否使用了扁平化步骤，未展开的字典或列表会直接变成字符串,导致列不对齐。
如何将json转csv并保留所有字段？
如果JSON的键是动态的，在线工具通常无法自动捕获所有列，建议使用Python的 json 模块遍历所有记录，收集所有键的并集，再逐行写入，具体做法是：第一遍遍历获取所有键，第二遍按顺序填充值，pandas的 json_normalize 默认会保留所有出现在第一条记录中的键，如果后续记录出现新键，可以通过 meta 参数补齐。
在线转换工具安全吗？
对于公开数据或无敏感信息的JSON，在线工具基本可用，但如果你处理的是用户信息、企业内部数据或业务凭证，最好使用本地脚本或命令行工具，据统计，近年有相当一部分数据泄露事件源于使用了不安全的在线转换平台，转换完成后，建议立即清除浏览器缓存,或直接使用离线环境完成操作。
核心结论：无论选择哪种方式，理解JSON的结构层次是准确转换的前提，对于一次性简单任务，在线工具胜在便捷；对于复杂或重复性需求，编程方法更可靠，掌握一种编程脚本,你就能在json转csv这条路上畅通无阻。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/%e5%a6%82%e4%bd%95%e5%b0%86json%e8%bd%ac%e4%b8%bacsv%e6%a0%bc%e5%bc%8f%ef%bc%9f%ef%bc%8c%e6%9c%89%e5%93%aa%e4%ba%9b%e8%bd%ac%e6%8d%a2%e5%b7%a5%e5%85%b7%ef%bc%9f/
