该技能是一份面向 Java 的语言级编码规范参考,用于在具体任务范围内指导更符合惯用法的 Java 写法。使用时需遵循当前项目约定,保持原有行为、所有权、错误处理、可访问性与安全性;示例为独立片段,并非在所有上下文中都等价的改写。应用前应核对语言与库版本并运行相关检查,必需的测试与面向用户的进度/结果优先于简洁性规则,不应仅为套用示例而安装依赖或删除文件。
主要内容按主题分段:
Streams 与集合:用 stream().filter().map().toList() 替代命令式累积(Java 16+,之前用 collect(Collectors.toList()));用 Collectors.groupingBy 替代手动分组;用 mapToInt().sum() 替代手动求和;优先方法引用而非等价 lambda。
Optional:用 Optional.ofNullable 链式 map 替代嵌套 null 检查;避免无 isPresent 判断的 get(),改用 orElse 或 orElseThrow;Optional 仅用于返回类型,不用作字段或参数。
Record 与数据类:用 record 替代手写 POJO;小型对象直接用 record 或构造器,仅在字段较多且可选时保留 Builder。
Switch 表达式:用 Java 14+ 的箭头式 switch 替代带 fall-through 和 break 的语句;用 Java 16+ 的 instanceof 模式匹配替代先判断再强转。
并发:用 ExecutorService(如 Java 21 的虚拟线程执行器)替代裸 Thread 创建,并观察提交任务的失败;用 AtomicInteger 等原子类替代 synchronized(this) 的细粒度计数;并行异步优先 CompletableFuture.allOf() 而非阻塞式 get() 链。
错误处理:避免捕获 Exception 后仅记录并吞掉;无法处理时包装为 unchecked 异常(如 UncheckedIOException);在边界处包装受检异常,内部方法抛 unchecked。
Java 反模式对照表:包括省略钻石操作符、Yoda 条件(改用 Objects.equals)、下标循环(改用增强 for 或 stream)、单线程用 StringBuffer(改用 StringBuilder)、printStackTrace(改用日志)、以 null 表示未找到(改用 Optional 返回类型)、公有字段(改用 private 加访问器或 record)、可变静态字段(改用依赖注入)、未用模式匹配的 instanceof 强转等。
限制:这些是语言级指南,不覆盖整体架构决策;过度压缩可能降低可读性,需自行判断取舍。