peek是stream api中用于调试的中间操作，不改变元素、不触发执行，需配合终端操作使用，适合观察过滤、映射等环节的数据状态，但不可用于副作用操作。
peek 是 Stream API 中一个不改变流元素、仅用于调试观察的中间操作，它在每个元素经过时执行指定的 Consumer 操作，然后原样传递该元素。它本身不会触发流的执行，必须配合终端操作（如 collect()、forEach()、count() 等）才会真正运行。
peek 的基本用法
在链式调用中插入 peek()，传入一个 lambda 表达式或方法引用，打印或记录当前元素：
- 适合快速查看某一步处理前后的数据形态
- 不能修改元素本身（因为 Consumer 参数是只读的）
- 若流被短路（如
findFirst()），peek 只对实际处理的元素生效
示例：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
List<string> result = Arrays.asList("apple", "banana", "cherry")
.stream()
.filter(s -> s.length() > 5)
.peek(s -> System.out.println("过滤后：" + s)) // 输出 banana, cherry
.map(String::toUpperCase)
.peek(s -> System.out.println("转大写后：" + s)) // 输出 BANANA, CHERRY
.collect(Collectors.toList());</string>
peek 常见调试场景
在复杂流链中定位问题时，peek 可放在关键节点后：
-
查过滤是否生效：在
filter()后加 peek，确认哪些元素留下 -
看映射是否正确：在
map()后加 peek，验证转换逻辑 -
检查去重/排序效果：在
distinct()或sorted()后加 peek -
识别空值或异常数据：结合打印 + null 判断，如
peek(s -> System.out.println("当前：" + Objects.toString(s, "NULL")))
peek 的注意事项
容易误用的地方要特别留意：
-
没有终端操作，peek 什么都不会打印 —— Stream 是惰性的，必须调用
collect()、forEach()等才会执行 -
不要在 peek 里做有副作用的业务逻辑（如修改外部变量、写文件、发请求），它不是设计来干这个的；应使用
forEach()替代 - 并行流中 peek 的输出顺序不确定，不适合依赖顺序的日志观察；调试并行流建议先用串行流 + peek 定位，再切回并行
- 避免过度使用：多个 peek 会让代码变冗长，可考虑提取成工具方法或用 IDE 断点调试替代
替代 peek 的轻量调试技巧
不想引入 peek？这些方式更简洁：
- 把流拆成变量分步执行，每步后加普通
System.out.println(list) - 用 IDE 调试模式，在流链断点处展开
Stream内部状态（部分 IDE 支持） - 封装一个调试工具方法：
static <t> Function<t t> log(String prefix) { return t -> { System.out.println(prefix + t); return t; }; }</t></t>，然后在 map/peek 中复用：peek(log("处理中: "))
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
