用途:为 Spring Boot 3 应用提供核心编码标准,覆盖应用结构、依赖注入(DI)与配置管理,属于 P0 关键优先级规范。
主要能力: 依赖注入:始终使用构造器注入以保证不可变性,用 Lombok 的 @RequiredArgsConstructor 减少样板代码,所有依赖声明为 final;禁止字段注入与 @Autowired。 配置与数据:用 @ConfigurationProperties 配合 Record(Java 17+)替代 @Value;使用按 profile 区分的配置文件(如 application-dev.yml、application-prod.yml),通过 SPRING_PROFILES_ACTIVE 设置激活 profile;禁止在配置文件中硬编码密钥。结合 @Validated 与 Jakarta Bean Validation(@NotNull、@NotEmpty)在启动时快速失败;使用 application.yaml 做结构化配置。用 record 作为不可变 DTO,用 Optional 处理空值以避免 NullPointerException。 可观测性与质量:用 @ControllerAdvice 与 ProblemDetails(RFC 7807)实现标准化错误响应;使用 SLF4J 与 @Slf4j,采用结构化日志写法(log.info("id: {}", id));强制使用 Spotless 或 Checkstyle 做代码格式化,用 sdkman 管理 JDK 21+ 版本。
反模式:禁止字段上的 @Autowired、依赖的 setter、context.getBean(),以及记录日志后吞掉异常(应重新抛出或显式处理)。
适用场景:Spring Boot 3 应用的结构搭建、DI 与配置编写及代码审查。
限制:资料未提供具体安装命令、收费信息与完整实现示例,相关细节暂未提供。