peek是stream的中间操作，用于调试时查看中间元素而不改变数据流。与map不同，peek不转换元素；与foreach不同，forEach是终止操作。常见误区是忽略Stream惰性求值，缺少终止操作时peek不会执行。使用peek可打印每步流转的元素，如过滤、映射前后的值，帮助定位问题。处理对象时可通过自定义输出关键字段提升可读性。注意事项：仅用于调试，避免修改状态，确保有终止操作，不依赖并行流中顺序。推荐结合日志框架使用，合理利用peek能显著提升Stream链式调用的可观察性与调试效率。
在Java开发中，使用Stream处理集合时，一旦链式操作增多，中间结果难以查看，调试变得困难。很多人习惯把Stream拆开或用日志打印，但其实Stream.peek是一个轻量又高效的调试工具。它不会改变数据流，只对每个元素执行一个操作（比如打印），非常适合观察中间状态。
peek 是什么？和 map、forEach 有什么区别？
peek是Stream的一个中间操作，接受一个Consumer函数，对每个流经的元素执行该操作，然后原样返回元素，不影响后续处理。这和map不同，map会转换元素；也和forEach不同，forEach是终止操作，执行后Stream就结束了。
常见误区：在没有终止操作的情况下调用peek，实际不会触发任何行为，因为Stream是惰性求值的。
如何用 peek 打印中间元素？
假设我们有一个字符串列表，想过滤出长度大于3的，转为大写，再收集。可以在每一步插入peek查看数据流转情况：
立即学习“Java免费学习笔记（深入）”；
List<String> result = Arrays.asList("a", "java", "stream", "debug") .stream() .peek(s -> System.out.println("原始元素: " + s)) .filter(s -> s.length() > 3) .peek(s -> System.out.println("过滤后: " + s)) .map(String::toUpperCase) .peek(s -> System.out.println("转大写: " + s)) .collect(Collectors.toList());
输出会清晰展示每一步的元素变化，帮助定位是哪一步出了问题。
peek 在复杂对象中的调试技巧
当处理自定义对象时，直接打印可能看不到关键字段。可以结合toString或选择性输出重要属性：
List<User> users = userList.stream() .peek(user -> System.out.printf("检查用户: id=%d, name=%s%n", user.getId(), user.getName())) .filter(User::isActive) .peek(user -> System.out.println("活跃用户: " + user)) .collect(Collectors.toList());
这样能快速确认过滤条件是否生效，或某个转换是否按预期执行。
注意事项与最佳实践
虽然peek方便，但使用时要注意几点：
- 仅用于调试，上线代码应移除或替换为日志框架（如slf4j）
- 不要在
peek中修改对象内部状态，可能引发副作用 - 确保有终止操作，否则
peek不会执行 - 避免在并行流中依赖
peek的输出顺序
如果需要记录到文件或控制台级别日志，建议用peek包装logger.info而不是System.out。
基本上就这些。合理使用Stream.peek，能让复杂的链式调用变得透明，提升调试效率，又不破坏原有逻辑。关键是理解它的“中间操作”特性，别忘了加终止操作。不复杂但容易忽略。