正确写法是list.stream().flatmap(sublist -> sublist.stream()).collect(collectors.tolist())，本质是映射后自动扁平化，需过滤null避免npe，支持并行且线程安全。
Java 8 flatMap 展平 List<list>></list> 的正确写法
直接用 flatMap 配合 stream()，不是 map + collect。错在这里的人，八成是把 flatMap 当成了“多一层 map”，其实它本质是「映射后自动扁平化」。
-
flatMap接收一个返回Stream<r></r>的函数，内部会把每个子流“打散”再合并；map返回的是List<stream>></stream>这种没法直接 collect 成单层 List - 常见错误：写成
list.map(subList -> subList.stream())然后卡住——这没用，类型不对，编译不过 - 正确链路：
list.stream().flatMap(subList -> subList.stream()).collect(Collectors.toList()) - 如果子列表可能为
null，必须提前过滤，否则flatMap里调null.stream()会抛NullPointerException
为什么不用 forEach + addAll？性能和语义问题
手写循环看似直白，但破坏了流式表达意图，且在并行场景下出错率高。更关键的是，它隐含了可变状态（往一个外部 ArrayList 里不断 addAll），而 flatMap 是纯函数式、天然支持 parallelStream()。
- 手动
addAll在多线程下需额外同步，而flatMap+collect的组合是线程安全的（只要收集器是无状态的，比如toList()） -
flatMap可以被 JVM 更好地优化，尤其在链式操作中（比如前面还有filter或map），中间不会生成多余中间集合 - 注意：
Collectors.toList()不保证返回ArrayList，如需特定实现，改用toCollection(ArrayList::new)
处理空子列表或 null 元素的防御写法
真实数据常有脏值，flatMap 对 null 零容忍，一碰到就崩。别指望它帮你跳过，得自己筛干净。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 过滤掉
null子列表：list.stream().filter(Objects::nonNull).flatMap(...) - 过滤掉子列表里的
null元素（如果需要）：subList.stream().filter(Objects::nonNull) - 如果子列表本身可能为空（
empty list），不用特别处理——空Stream被flatMap合并时自然不贡献元素 - 示例完整写法：
list.stream().filter(Objects::nonNull).flatMap(sub -> sub == null ? Stream.empty() : sub.stream()).collect(toList())
泛型擦除下 flatMap 的类型推导陷阱
IDE 有时报红或提示「incompatible types」，不是你写错了，而是 Java 泛型擦除导致编译器无法从 lambda 推出返回流的类型。显式声明能救场。
- 当
subList类型不明确（比如是Object或原始类型集合），加类型标注：flatMap((List<string> subList) -> subList.stream())</string> - 或者用方法引用替代 lambda：
flatMap(List::stream)—— 这种写法更简洁，且类型推导成功率更高 - 若源集合是
List extends List<t>></t>，建议先cast或用通配符限定，避免运行时ClassCastException
最易被忽略的一点：展平操作本身不改变元素顺序，但如果你在 flatMap 前用了 parallelStream()，子列表间的顺序仍保留，子列表内部顺序也保留，但不同子列表的元素可能交错——这不是 bug，是并行流的正常行为。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
