Java Stream中map与forEach的区别详解（含代码示例）

AI 小北

2026-6-23

Java Stream中map与forEach的核心区别解析

先看你给出的两段代码，本质上是在体现map和forEach在定位、执行逻辑、使用场景上的核心差异，下面拆解清楚：

1. 操作类型：中间操作 vs 终端操作

这是最本质的区别：

map是中间操作：它属于Stream的"惰性操作"，调用后不会立即执行，只是在流的操作链里添加一个转换逻辑，只有当后面跟了终端操作（比如示例里的collect(Collectors.toList())）时，整个流的操作才会被触发执行。
比如你把第一段代码里的.collect(...)删掉，map里的System.out.println(i)根本不会打印任何内容——因为中间操作本身不会启动流的遍历。
forEach是终端操作：它是流的"触发点"，调用后会立即启动流的遍历，执行每个元素的处理逻辑，操作完成后流就会被消耗，无法再复用。

两者的职责完全不同：

map的核心作用是转换流中的元素：它接收一个Function接口，把流中的每个元素转换成另一个元素（可以是同类型或不同类型），最终输出一个包含转换后元素的新流。示例里的map只是返回原元素，属于无意义的转换，实际场景中你可能会做user -> user.getUsername()这种提取字段的转换。
⚠️ 注意：map不应该用来处理副作用（比如打印、修改外部集合），这违背了它的设计初衷，副作用应该交给终端操作处理。
forEach的核心作用是消费流中的元素：它接收一个Consumer接口，对每个元素执行带有副作用的操作（比如打印、写入文件、添加到外部集合），没有返回值（返回void），只是单纯处理元素。

userList.stream().map(i -> {
    System.out.println(i);
    return i;
}).collect(Collectors.toList());

这段代码里，map的打印属于"不恰当的副作用"，真正的有效逻辑是把原集合的元素复制到一个新列表里（通过collect）。如果把map换成peek（专门用来做中间操作的副作用调试）会更合理，但这里用map也能跑，只是不符合设计规范。

List<User> arrayList = new ArrayList<>();
userList.stream().forEach(i -> {
    System.out.println(i);
    arrayList.add(i);
});

这段代码是forEach的典型用法：遍历元素并执行副作用（打印+添加到外部集合）。不过如果只是要复制集合，用collect(Collectors.toList())比手动用forEach添加更简洁、更符合Stream的函数式风格。

链式调用：map作为中间操作，可以和其他中间操作（比如filter、distinct）链式调用，构建复杂的流处理逻辑；而forEach是终端操作，调用后流就结束了，不能再跟其他流操作。
返回值：map返回一个新的Stream对象；forEach返回void，没有返回值。

内容的提问来源于stack exchange，提问作者Vivyen