flatMap是处理嵌套结构并同步扁平化的首选方法,适用于提取子数组、遍历树形结构、一对多映射过滤、聚合响应嵌套数据等场景,一次遍历、语义明确、性能更优。

flatMap 是处理嵌套结构并同步扁平化的首选方法,尤其适合“一边提取或转换,一边摊平”的场景。它不是先 map 再 flat(1) 的简单拼接,而是一次遍历、语义明确、性能更优的原生方案。
提取子数组并合并成一维列表
当数据结构是数组中包含多个子数组(如 API 返回的 items: Array<T[]>),直接用 flatMap 可省去中间数组创建:
-
[[1, 2], [3], [4, 5, 6]].flatMap(x => x)→[1, 2, 3, 4, 5, 6] - 比
arr.map(x => x).flat(1)少一次内存分配,也比手写reduce((a, b) => a.concat(b), [])更清晰
遍历树形结构生成平级列表
菜单、分类、组织架构等常见树状数据,可用 flatMap 一层展开并携带上下文信息:
- 每个父节点有
children数组,想拉出所有子项并标记所属父级名称 menuTree.flatMap(parent => parent.children.map(child => ({ ...child, parentName: parent.name })))- 结果是扁平数组,每个元素含原始子项字段 + 父级附加字段,无需后续 join 或 map 补充
一对多映射 + 过滤合并
一个源元素可能产出零个、一个或多个目标元素,flatMap 天然支持这种弹性输出:
- 用户对象带
orders数组,只保留有效订单:users.flatMap(u => u.orders.filter(o => o.status === 'paid')) - 字符串拆词并去重清洗:
['hello world', 'java script'].flatMap(s => s.split(' ').map(w => w.trim()).filter(Boolean)) - 返回空数组会被自动跳过,不占位也不报错
处理响应体中的嵌套数据集合
后端常返回类似 { data: [{ items: [...] }, { items: [...] }] } 的结构,前端需聚合全部 items:
-
res.data.flatMap(group => group.items)一行完成提取+合并 - 若还需转换字段(如加前缀、格式化时间),可直接在回调里做:
group.items.map(item => ({ ...item, source: group.id })) - 相比先
map(...).flat(1),这里避免了构建中间二维数组,对大数据量更友好

















