optional不可用作参数或字段，因其设计初衷仅为方法返回值；用作字段会导致序列化、orm等异常，用作参数则增加冗余且违背语义。
别用 Optional 当参数或字段
Optional 的设计初衷是作为方法返回值，用来明确表达“可能为空”的语义。把它当方法参数传入，会导致调用方必须包装 null 或值，反而增加冗余；作为类字段更危险——序列化、反射、ORM（如 Hibernate）大多不支持 Optional 字段，运行时容易抛 NullPointerException 或 InvalidDefinitionException。
✅ 正确做法：
- 返回值用 Optional
表示查找可能无结果 - 参数保持原始类型，如 String id，空值校验交给业务逻辑（如 Objects.requireNonNull 或 Spring 的 @NotBlank）
- 字段用 String name，需要表达“未设置”语义时，配合注释或专用状态字段（如 isNameSet）
避免链式调用中隐性 NPE
像 optional.map(...).filter(...).orElse(...) 看似安全，但一旦中间某个函数返回 null（比如 map 里写了 s -> s.toUpperCase() 而 s 是 null），整个链就会在运行时崩掉——Optional.map 不会自动跳过 null 输入。
✅ 安全写法：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 确保 map/filter/flatMap 中的 lambda 不返回 null（改用 Optional.ofNullable 包装）
- 对可能为 null 的中间结果，先用 Optional.ofNullable(x) 再操作
- 复杂逻辑建议拆成显式判断，例如：
if (opt.isPresent()) { String s = opt.get(); ... }
orElse 和 orElseGet 别乱选
orElse(value) 无论 Optional 是否有值，都会执行 value 的计算（哪怕只是 new 一个大对象）；orElseGet(Supplier) 只在为空时才调用 supplier。
✅ 性能敏感场景必须用 orElseGet：
- 替代 orElse(new HeavyObject()) → 改为 orElseGet(HeavyObject::new)
- 涉及 IO 或耗时操作（如查缓存、远程调用）一律用 orElseGet
- 仅当默认值是常量（如 orElse("N/A")）或极轻量对象时，orElse 才可接受
慎用 isPresent() + get() 组合
写成 if (opt.isPresent()) { return opt.get(); } 等价于裸奔——既没提升可读性，又因两次内部判空（isPresent 和 get 都检查）略损性能，还掩盖了 Optional 的函数式意图。
✅ 更清晰的替代方式：
- 要转换：用 map(...).orElse(...)
- 要过滤：用 filter(...).orElse(null) 或直接 filter(...).ifPresent(...)
- 要分支逻辑：用 ifPresentOrElse(consumer, runnable)（Java 9+）
- 真需要解包且后续多步操作：考虑是否该重构为普通 null 检查，Optional 并非银弹
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
