该技能为 Spring Boot 服务提供 Java(17+)编码规范,重点在于写出可读、可维护的代码。
用途与激活时机:在 Spring Boot 项目中编写或评审 Java 代码、强制执行命名/不可变性/异常处理约定、使用 records、密封类或模式匹配、评审 Optional/流/泛型用法、规划包结构与项目布局时适用。
核心原则:清晰度优先于技巧性;默认不可变并尽量减少共享可变状态;快速失败并给出有意义的异常信息;保持命名和包结构一致。
主要内容:命名采用类/record 大驼峰、方法/字段小驼峰、常量全大写蛇形;优先 records 与 final 字段、仅提供 getter;find* 方法返回 Optional,使用 map/flatMap 而非 get();流用于转换并保持流水线简短,避免复杂嵌套流;领域错误用非受检异常并创建领域特定异常,避免宽泛 catch;避免原始类型,使用有界泛型;包结构按 config、controller、service、repository、domain、dto、util 组织,测试目录镜像 main;格式上每文件一个公共顶级类型,成员按常量、字段、构造函数、公共/受保护/私有方法排序;记录日志使用 LoggerFactory,避免沉默 catch、过长参数、深层嵌套、魔法数字与静态可变状态。测试期望使用 JUnit 5 + AssertJ、Mockito,避免部分 Mock 与隐藏 sleep。
限制:资料未提供安装命令、价格、平台或工具链细节,具体版本适配与执行方式暂未提供。