Java Stream的lambda表达式禁止修改外部变量，因lambda只能捕获effectively final变量；应使用filter+findFirst替代forEach赋值，用collect收集结果，中间操作须无状态，空值需前置过滤。
不能在 Stream 的 lambda 表达式里直接修改外部变量，这是 Java 编译器强制的限制，根本原因在于 lambda 只能捕获 effectively final 的局部变量。企业级开发中，这种写法不仅编译不过，更会破坏函数式语义、引发并发风险、降低可读性和可测试性。
用 filter + findFirst 替代 forEach 中赋值
常见错误是用 forEach 遍历并手动设标志位或结果变量：
List<String> list = List.of("a", "b", "c");<br>String target = null;<br>boolean found = false;<br>list.stream().forEach(s -> {<br> if ("b".equals(s)) {<br> target = s;<br> found = true;<br> }<br>});
这会触发编译错误（target 和 found 非 final），即使加 volatile 或 AtomicInteger 也违背 Stream 设计原则。
立即学习“Java免费学习笔记（深入）”；
✅ 正确做法：用声明式操作替代状态变更：
- 用
filter(条件).findFirst()获取匹配项，返回Optional<T> - 用
orElse("")或orElseThrow()显式处理空值 - 用
isPresent()判断是否存在，替代布尔标志
收集结果必须用 collect，禁用外部容器累加
在并行流中，向外部 ArrayList 或 HashSet 添加元素是高危操作，会导致数据丢失或 ConcurrentModificationException。
List<String> result = new ArrayList<>();<br>list.parallelStream().forEach(s -> result.add(s.toUpperCase()));
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
✅ 正确做法：
- 统一使用
collect(Collectors.toList())或toList()（JDK 16+） - 若需定制逻辑，用
collect(Supplier, BiConsumer, BiConsumer)构建线程安全收集器 - 绝对避免在 lambda 内调用外部集合的
add、put、set等方法
所有中间操作保持无状态，不读写共享对象
map、filter、sorted 等中间操作应只依赖输入参数，不访问类字段、静态变量或外部缓存。
❌ 错误示例：private int counter = 0;<br>list.stream().map(s -> { counter++; return s.length(); });
这类副作用会导致结果不可预测，尤其在 parallelStream 中完全失效。
✅ 正确做法：
- 把计数、累积等逻辑移到终止操作中，例如用
reduce或summarizingInt - 如需索引，用
IntStream.range(0, list.size()).mapToObj(i -> ...)，避免维护外部下标 - 业务状态变更（如更新数据库、发消息）应放在终端操作
forEach中，且仅用于消费，不用于控制流
空值与边界场景必须前置防御
Stream 元素本身为 null 时，filter、map、compareTo 都可能抛 NPE，不能依赖 Optional 掩盖问题。
✅ 必须做：
- 在链式开头加
filter(Objects::nonNull)过滤空元素 - 对可能为空的字段做判空处理，例如
map(p -> p.getName() != null ? p.getName().trim() : "") - toMap 前确保 key 和 value 非 null，可用
filter或map提供默认值
