findFirst 返回 Optional 而非直接元素，本质是显式暴露“是否存在”的事实，避免空指针；必须用 orElse/orElseGet/ifPresent 等安全解包，不可直接调用 get()，且需注意其依赖遭遇顺序、并行流中不保证原始序。
findFirst 返回一个 Optional，不是直接返回元素，这是它“安全”的核心——避免空指针。
为什么 findFirst 是安全的
因为流可能为空（比如过滤后没匹配项、空集合转的流），直接取第一个会抛 NoSuchElementException。而 findFirst() 总是返回 Optional<t></t>，把“是否存在”这个事实显式暴露出来，由你决定如何处理缺失情况。
正确使用 Optional 的三种常见方式
❌ 错误示范：直接 get()（仍可能 NPE）String first = list.stream().filter(...).findFirst().get(); // 流为空时抛异常
✅ 推荐方式一：orElse 提供默认值String first = list.stream().filter(s -> s.startsWith("A")).findFirst().orElse("默认值");
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
✅ 推荐方式二：orElseGet 延迟计算默认值（适合开销大或有副作用的场景）String first = stream.findFirst().orElseGet(() -> computeDefault());
✅ 推荐方式三：ifPresent 做存在性消费（只在有值时执行逻辑）stream.findFirst().ifPresent(user -> System.out.println("找到用户：" + user.getName()));
注意短路与顺序性
findFirst 是短路操作，遇到第一个满足条件的元素就停止遍历，性能好；但它依赖流的**遭遇顺序（encounter order）**。对有序流（如 ArrayList 的 stream），结果可预测；对无序流（如 parallelStream() 或 HashSet 的 stream），findFirst 行为不确定——此时应改用 findAny。
和 findAny 的关键区别
-
findFirst：强调“第一个”，要求流有定义好的顺序，适合需要确定性结果的场景 -
findAny：强调“任一个”，并行流中更高效，结果不保证是“第一个”
