Stream.peek可调试数据流，它作为中间操作在不改变流的前提下打印日志，帮助定位过滤、映射等环节问题，需注意避免副作用并结合日志框架使用。
在Java开发中，Stream API让集合处理变得更简洁高效，但在调试时却带来一个难题：中间操作无法直接观察数据流转。这时候，Stream.peek 方法就成了一个非常实用的调试工具。
peek方法的基本作用
peek方法是Stream中的中间操作，它接收一个Consumer函数式接口，对流中的每个元素执行指定的操作，比如打印或记录日志，然后返回包含原元素的新流。它不会改变元素内容，也不会中断流的执行链。
与forEach不同，forEach是终止操作，调用后流就关闭了；而peek可以插入在多个中间操作之间，帮助我们“窥探”数据状态。
基本语法如下：
立即学习“Java免费学习笔记（深入）”；
stream
.filter(e -> e > 5)
.peek(e -> System.out.println("过滤后: " + e))
.map(e -> e * 2)
.peek(e -> System.out.println("映射后: " + e))
.collect(Collectors.toList());
在实际调试中的典型场景
当我们面对一长串Stream操作时，如果最终结果不符合预期，很难定位问题出在哪一步。通过合理使用peek，可以在关键节点输出信息。
SuperCms在线订餐系统
下载
模板采用响应式设计，自动适应手机，电脑及平板显示；满足单一店铺外卖需求。功能：1.菜单分类管理2.菜品管理：菜品增加，删除，修改3.订单管理4.友情链接管理5.数据库备份6.文章模块：如：促销活动，帮助中心7.单页模块：如：企业信息，关于我们更强大的功能在开发中……安装方法：上传到网站根目录，运行http://www.***.com/install 自动
- 查看过滤前后的元素变化，确认条件是否生效
- 检查map转换是否正确，特别是复杂对象字段映射
- 验证distinct、sorted等操作的实际影响
- 排查null值出现在哪个环节导致空指针异常
例如，处理用户列表时：
ListactiveUsers = users.stream() .peek(user -> System.out.println("原始用户: " + user.getName())) .filter(User::isActive) .peek(user -> System.out.println("激活用户: " + user.getName())) .map(User::toDto) .peek(dto -> System.out.println("转换DTO: " + dto)) .collect(Collectors.toList());
注意事项和最佳实践
虽然peek很适合调试，但使用时也要注意几点。
- 不要在生产代码中保留大量打印语句，可结合日志框架控制输出级别
- peek中的操作应尽量轻量，避免副作用（如修改外部变量或执行耗时操作）
- 理解peek是中间操作，必须有终端操作才会触发执行
- 不要依赖peek来修改流内容，它设计初衷是用于观察而非改变
可以把调试代码封装成条件日志：
.peek(user -> {
if (log.isDebugEnabled()) {
log.debug("当前用户: {}", user);
}
})
基本上就这些。peek不是功能性的API，而是开发者的好帮手，在排查Stream流程时能快速定位问题，提升调试效率。
