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), [])更直观、不易出错
遍历树形结构生成平级列表
菜单、分类、组织架构等树状数据,常需拉出所有子项并携带上下文信息:
- 每个节点含
children数组,想展开全部子项并标记父级名称:menuTree.flatMap(parent => parent.children.map(child => ({ child, parentName: parent.name }))) - 结果是扁平数组,每个元素已含原始子项字段 + 父级附加字段
- 无需后续
map补字段或flat二次处理
一对多映射 + 过滤合并
一个源元素可能产出零个、一个或多个目标元素,flatMap 天然支持弹性输出:
立即学习“Java免费学习笔记(深入)”;
- 用户对象带
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 })) - 避免构建中间二维数组,对大数据量更友好


















