flatMap的核心是“先映射为流，再自动合并”，专用于一对多关系的扁平化处理；与map的一对一映射不同，flatMap将每个元素转为Stream并展平为单一流，如嵌套列表、对象集合或字符串拆分等场景。

Java Stream API 的扁平化核心在于 flatMap —— 它不是简单映射，而是“映射成流再自动合并”。只要结构存在“一对多”关系（比如一个对象含多个子项、一个 Map 含多个 Entry、一个字符串要拆成多个字符），就适合用 flatMap 拉平。

flatMap 与 map 的本质区别

map 是一对一：输入一个元素，输出一个新元素，流的层级不变；
flatMap 是一对多 + 合并：输入一个元素，输出一个 Stream，所有子 Stream 被拍平为单一流。
例如：
• list.stream().map(s -> s.split("")) 得到的是 Stream<string></string>，仍是嵌套结构；
• list.stream().flatMap(s -> Arrays.stream(s.split(""))) 得到的是 Stream<string></string>，真正展开了。

三层嵌套结构的一次性展平

当数据模型为 C → List → List，需生成 D(a, b, c) 对象时：
• 外层调用 cList.stream() 启动流；
• 第一层 flatMap(b -> ...) 将每个 C 映射为其 B 列表的流；
• 第二层 flatMap(a -> ...) 在每个 B 内部，将其 A 列表转为流；
• 最后用 map 构造 D，此时 a、b、c 均在作用域内，可直接访问字段（如 a.getA1()、b.getB1()、c.getC1()）；
• 整个链式操作惰性执行，仅遍历一次，时间复杂度与传统双 for 循环一致。

OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载

嵌套 Map 的逐层解包

面对 List<c></c> → C.map: Map<string b></string> → B.map: Map<string a></string> → A.value 的结构：
• .flatMap(c -> c.getMap().values().stream()) 解出所有 B；
• .flatMap(b -> b.getMap().values().stream()) 解出所有 A；
• .mapToInt(A::getValue).sum() 提取并聚合数值；
关键点在于每层都用 .values().stream() 获取子集合流，flatMap 负责串联与展平，无需手动迭代或临时集合。

立即学习“Java免费学习笔记（深入）”；

扁平化后的数据收集策略

展平之后，根据目标格式选择终端操作：
• 要列表：用 .collect(Collectors.toList())；
• 要求和/计数：用 .mapToInt(...).sum() 或 .count()；
• 要转 Map：用 .collect(Collectors.toMap(Entry::getKey, Entry::getValue, (v1, v2) -> v1))，第三个参数处理键冲突；
• 空值安全建议：在 flatMap 前加 .filter(Objects::nonNull)，或对子集合做 Optional.ofNullable(...).orElse(Collections.emptyList()).stream() 防御。