flatMap() 是 JavaScript 中将 map() 和 flat(1) 合并为一步的数组方法,先映射每个元素(返回任意结构,含数组),再自动展开一层嵌套,适用于单次遍历中完成拆解、清洗与重构,避免中间数组、提升性能与可读性。

flatMap() 是 JavaScript 中一个强大而简洁的数组方法,它把 map() 和 flat(1) 合并为一步:先对每个元素执行映射函数(返回任意结构,包括数组),再自动展开一层嵌套。这使得它特别适合在单次遍历中完成“拆解 → 清洗 → 重新包装”三步操作,避免中间数组、减少循环次数、提升可读性。
用 flatMap 替代 map + filter + flat 的组合
常见场景是:从一组对象中提取字段(可能为数组)、过滤无效值、再统一转成标准结构。传统写法需多次遍历:
❌ 不推荐(三次遍历)data.map(item => item.tags).filter(Boolean).flat().map(tag => ({ type: 'tag', value: tag }))
用 flatMap 可压缩为一次迭代:
✅ 推荐(单次遍历)data.flatMap(item =>
Array.isArray(item.tags) && item.tags.length
? item.tags.map(tag => ({ type: 'tag', value: tag.trim() }))
: []
)
关键点:
- 映射函数返回数组(清洗后的新结构),空数组会被展开为“无元素”,自然实现过滤
-
trim()在映射时完成清洗,不依赖额外filter - 无需预先
flat(1),flatMap 自动处理一层展开
处理嵌套结构并扁平化关联数据
例如:用户列表中每个用户有多个订单,需生成“用户-订单”明细行,同时剔除测试用户或无效订单:
users.flatMap(user =>
user.isTest || !Array.isArray(user.orders)
? []
: user.orders
.filter(order => order.status !== 'cancelled' && order.amount > 0)
.map(order => ({
userId: user.id,
userName: user.name,
orderId: order.id,
amount: Number(order.amount.toFixed(2)),
timestamp: new Date(order.time)
}))
)
说明:
- 顶层判断跳过测试用户,直接返回空数组(不参与展开)
- 内部
filter和map在同一轮中完成清洗与重构 -
Number(...toFixed(2))在映射中做数值标准化,避免后续处理
安全拆解可能为 null/undefined 的字段
API 返回结构不稳定时,常需防御性编程。flatMap 天然支持“条件返回空数组”来规避错误:
apiResponse.flatMap(item =>
item?.metadata?.categories?.map(cat =>
cat?.name?.trim() && cat?.id
? { category: cat.name.trim(), id: cat.id, source: item.id }
: null
).filter(Boolean) || []
)
更简洁写法(利用 flatMap 对 null/undefined 的宽容性):
apiResponse.flatMap(item =>
item?.metadata?.categories?.map(cat => {
const name = cat?.name?.trim();
return name && cat?.id ? { category: name, id: cat.id, source: item.id } : [];
}) || []
)
注意:flatMap 会把 []、null、undefined 都当作“无内容”处理,但不会报错 —— 这正是它比 map().flat() 更鲁棒的地方。
与 reduce 对比:何时选 flatMap?
虽然 reduce 也能完成类似任务,但 flatMap 更聚焦、更声明式:
- 当你目标是“每个输入 → 零个或多个标准输出”,且逻辑以“元素为中心”,优先用 flatMap
- 当需要跨元素累积状态(如计数、合并、依赖前序结果),才考虑 reduce
- flatMap 不改变原数组,不可变性友好;reduce 若不谨慎易产生副作用
例如:统计并展开所有非空评论,flatMap 清晰直白;若还需同时计算总字数,则 reduce 更合适。










