Учебники2026-01-24•8 мин чтения
Как конвертировать вложенный JSON в CSV: Полное руководство
Пошаговое руководство по обработке сложных вложенных структур JSON при конвертации в формат CSV.
简介
将嵌套 JSON 转换为 CSV 是数据处理中的常见挑战。虽然 CSV 是一种扁平的表格格式，但 JSON 可以表示复杂的层次结构。本指南将引导您了解将嵌套 JSON 数据扁平化为 CSV 格式的策略和技术，同时尽可能保留更多信息。
理解挑战
根本问题在于 CSV 是二维格式（行和列），而 JSON 可以有多层嵌套。在转换之前，您需要决定如何在扁平结构中表示嵌套数据。
// 示例：嵌套 JSON 结构
{
"users": [
{
"id": 1,
"name": "张三",
"address": {
"street": "中山路123号",
"city": "北京",
"country": "中国"
},
"orders": [
{ "orderId": "A001", "amount": 99.99 },
{ "orderId": "A002", "amount": 149.99 }
]
}
]
}常见的嵌套结构:
- 对象内的对象（嵌套属性）
- 对象数组（一对多关系）
- 基本值数组
- 混合嵌套（包含数组的对象，数组中又包含对象）
- 深度嵌套数据（3 层以上）
策略 1：扁平化嵌套对象
嵌套对象最简单的方法是使用点表示法或下划线分隔符将它们扁平化。这对于始终存在且具有一致结构的对象效果很好。
// 扁平化嵌套对象
function flattenObject(obj, prefix = '') {
const flattened = {};
for (const [key, value] of Object.entries(obj)) {
const newKey = prefix ? `${prefix}_${key}` : key;
if (value && typeof value === 'object' && !Array.isArray(value)) {
// 递归扁平化嵌套对象
Object.assign(flattened, flattenObject(value, newKey));
} else if (Array.isArray(value)) {
// 单独处理数组
flattened[newKey] = JSON.stringify(value);
} else {
flattened[newKey] = value;
}
}
return flattened;
}
// 使用示例
const user = {
id: 1,
name: "张三",
address: {
street: "中山路123号",
city: "北京",
country: "中国"
}
};
const flat = flattenObject(user);
// 结果:
// {
// id: 1,
// name: "张三",
// address_street: "中山路123号",
// address_city: "北京",
// address_country: "中国"
// }何时使用此策略:
- 嵌套对象具有固定、可预测的结构
- 每个父对象恰好有一个嵌套对象
- 嵌套级别较浅（1-2 层）
- 您希望在单行中保留所有数据
策略 2：创建多行
当您有对象数组时，可以创建多个 CSV 行 - 每个数组元素一行。这对于一对多关系很有用，您希望保留父记录和子记录之间的关系。
// 为数组项创建多行
function expandArrays(data) {
const rows = [];
data.forEach(item => {
const baseData = { ...item };
delete baseData.orders; // 移除数组字段
if (item.orders && item.orders.length > 0) {
// 为每个订单创建一行
item.orders.forEach(order => {
rows.push({
...baseData,
orderId: order.orderId,
orderAmount: order.amount
});
});
} else {
// 如果没有订单，仍包含基本数据
rows.push({ ...baseData, orderId: null, orderAmount: null });
}
});
return rows;
}
// 示例结果:
// [
// { id: 1, name: "张三", orderId: "A001", orderAmount: 99.99 },
// { id: 1, name: "张三", orderId: "A002", orderAmount: 149.99 }
// ]何时使用此策略:
- 您有一对多关系（例如，用户 → 订单）
- 每个数组元素都很重要，需要自己的行
- 您可以接受数据重复
- 数组大小可管理（不是数百个项目）
策略 3：序列化复杂数据
对于复杂或可变的结构，您可以将嵌套数据序列化为 CSV 单元格中的 JSON 字符串。这会保留所有信息，但使数据难以进行分析。
// 序列化复杂嵌套数据
function serializeNested(data) {
return data.map(item => {
const result = {
id: item.id,
name: item.name,
// 将嵌套对象/数组序列化为 JSON 字符串
address: JSON.stringify(item.address),
orders: JSON.stringify(item.orders),
metadata: JSON.stringify(item.metadata)
};
return result;
});
}
// CSV 将看起来像：
// id,name,address,orders
// 1,"张三","{""street"":""中山路123号"",""city"":""北京""}","[{""orderId"":""A001""}]"何时使用此策略:
- 嵌套结构高度可变或不可预测
- 您需要保留确切的结构以便以后处理
- 数据不会在电子表格软件中直接分析
- 您使用 CSV 作为传输格式，而不是用于分析
策略 4：创建单独的 CSV 文件
对于具有多个一对多关系的复杂数据，考虑为每种实体类型创建单独的 CSV 文件，类似于数据库规范化。
// 为相关数据创建单独的 CSV 文件
function splitIntoTables(data) {
const users = [];
const orders = [];
const addresses = [];
data.forEach(user => {
// 用户表
users.push({
userId: user.id,
name: user.name
});
// 地址表
if (user.address) {
addresses.push({
userId: user.id,
street: user.address.street,
city: user.address.city,
country: user.address.country
});
}
// 订单表
if (user.orders) {
user.orders.forEach(order => {
orders.push({
orderId: order.orderId,
userId: user.id,
amount: order.amount
});
});
}
});
return { users, orders, addresses };
}
// 结果是三个单独的 CSV 文件：
// users.csv, orders.csv, addresses.csv
// 以 userId 作为外键何时使用此策略:
- 您有多层嵌套数组
- 数据量大，重复会浪费资源
- 您需要保持引用完整性
- 数据将导入关系数据库
- 您想避免数据重复
最佳实践和技巧
无论您选择哪种策略，请牢记这些最佳实践，以确保您的转换可靠且易于维护。
重要注意事项:
- 在代码注释中记录您的扁平化策略
- 优雅地处理缺失或 null 的嵌套值
- 使用真实世界的数据样本进行测试，而不仅仅是理想情况
- 选择策略时考虑最终用例
- 验证输出以确保没有数据丢失
- 为扁平化字段使用一致的命名约定
- 为序列化的 JSON 字符串实施适当的 CSV 转义
- 考虑大型数据集的内存使用
选择正确的策略
最佳方法取决于您的具体用例。对简单的嵌套对象使用扁平化，为需要分析的一对多关系创建多行，为保留复杂结构序列化，为规范化数据创建单独的文件。通常，这些策略的组合效果最好。始终验证您的输出，并确保转换满足下游流程的需求。
Handle Nested JSON with Ease
Use our JSON to CSV tool to automatically handle nested structures without manual coding.