核心是组合使用flatMap、map、Object.values和字符串转义逻辑，并通过字段路径映射+扁平化取值将多维对象数组精准转为CSV行数据，确保列顺序、缺省处理与嵌套/数组兼容。
在复杂报表导出中，将多维对象数组转为标准 CSV 行数据，核心不是靠单个 API，而是组合使用 Array.prototype.flatMap、Array.prototype.map、Object.values 和字符串转义逻辑，再配合字段扁平化策略。
明确“多维对象数组”的结构特征
常见复杂结构如：
- 嵌套对象：
{ name: "张三", dept: { id: 1, name: "研发部" } } - 数组字段：
{ tags: ["前端", "React"], scores: [85, 92] } - 混合层级：
{ user: { profile: { age: 28 } }, logs: [{ time: "2024-01-01", action: "login" }] }
CSV 是二维表格式，必须将上述结构“拍平”为每行一个对象、每列一个原子值。不能直接用 JSON.stringify 或 Object.values 原样调用，否则会生成非法逗号或换行。
用字段路径映射 + 扁平化取值（推荐方案）
定义字段路径数组（类似 Excel 列头），逐行提取对应值，自动处理嵌套与数组：
立即学习“Java免费学习笔记（深入）”；
const headers = [
"name",
"dept.name",
"tags.0",
"tags.1",
"scores.0",
"scores.1"
];
function getNestedValue(obj, path) {
return path.split('.').reduce((val, key) => {
if (val == null) return '';
if (Array.isArray(val) && /^\d+$/.test(key)) return val[parseInt(key)] ?? '';
return val[key] ?? '';
}, obj);
}
const csvRows = data.map(row =>
headers.map(header => {
const val = getNestedValue(row, header);
// CSV 转义：含逗号、换行、双引号的字段用双引号包裹，内部双引号转义为两个双引号
if (typeof val === 'string' && /[,\"\n\r]/.test(val)) {
return `"${val.replace(/"/g, '""')}"`;
}
return String(val);
}).join(',')
);
这样可精准控制列顺序、支持缺省值（?? ''）、兼容数组索引和深层嵌套。
对数组字段做横向展开（如 tags → tag1, tag2, tag3）
若某字段是不定长数组（如 tags: ["A", "B"]），需先统一长度再展开：
- 统计所有数据中该字段最大长度（例如最多 5 个 tag）
- 用
Array.from({ length: 5 }, (_, i) => `tags.${i}`)动态生成字段路径 - 取值时用
getNestedValue(row, `tags.${i}`)，自动返回undefined→ 空字符串
避免用 flatMap 直接展开成多行（那会破坏报表行级语义），CSV 行数必须与原始对象数组长度一致。
生成最终 CSV 字符串并触发下载
拼接表头与数据行，构造 Blob 下载：
const csvContent = [
headers.join(','), // 表头
...csvRows
].join('\n');
const blob = new Blob([csvContent], { type: 'text/csv;charset=utf-8;' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'report-export.csv';
a.click();
URL.revokeObjectURL(url);
注意：中文需确保 UTF-8 BOM 头（尤其 Excel 打开乱码时），可在 csvContent 开头加 \uFEFF。
