Java Stream API处理嵌套集合的流式处理逻辑

使用 flatMap 处理嵌套集合

在处理嵌套集合时，最核心的一个操作就是 flatMap——或者说，它的职责就是“拆一层”。 先说结论：当你的数据是 List> 这种结构时，直接调用 .stream() 得到的流，其元素类型仍然是 List，而不是 String。整个流里装的是一堆“小列表”，而不是单个字符串。这就是所谓的“流中含流”。如果想对这些小列表里的每一个字符串做操作（比如过滤、转换），必须先把这个外层流“拍平”。

map 与 flatMap 的区别

如果写 map(List::stream)，操作的结果是 Stream>——每个元素变成了一个字符串流。放在一起，就是一个流的流，还是嵌套的。这等于把盒子里的东西又装进了另一个盒子，没法直接 collect 成你要的结果。 但 flatMap(List::stream) 就不同了。它的逻辑是：对每个元素（也就是每个小列表）执行一个操作，这个操作必须返回一个 Stream，然后自动把所有这些返回的流合并成一个新的流。这是一个“一对多 + 合并”的连贯动作，不是拆开的两步。

实际例子

举个例子，如果要统计所有小列表里不重复的字符串，只需 .flatMap(List::stream).distinct().collect(Collectors.toSet())，一步到位。 如果只想保留长度大于 3 的单词：.flatMap(List::stream).filter(s -> s.length() > 3).collect(Collectors.toList())。 还有更灵活的用法：如果你想在展开的同时做跨层级映射，比如 .flatMap(list -> list.stream().map(s -> s.toUpperCase()))，每个小列表的元素都转成大写，再合并成一个流。这比先 flatMap 再 map 更紧凑，但逻辑是一样的。

警惕引用语义带来的副作用陷阱

Stream 操作本身是无状态、不可变的，它不会主动修改原始集合。但如果你在 flatMap 内部调用 subList.clear() 或 subList.add(...)，这些调用会真实影响原数据，因为 List 引用没有变。而像 list.set(i, new ArrayList()) 这类赋值，只改局部变量，不影响原始嵌套结构。 这里要特别强调：不要在 flatMap 或 forEach 中试图“往外部集合 add 元素”。这违反流的设计原则，也容易导致并发问题。收集结果始终应通过 collect() 完成。想做什么操作，就在流的管道里做，不要指望在流外面“攒”结果。

推荐写法

最后说一个常见的写法：如果你在 flatMap 里对每个子列表做转换，建议直接写成 lambda，而不是方法引用，这样更直观。比如 .flatMap(list -> list.stream().map(...))，一眼就能看出逻辑。