要在maven中正确启用apt，核心是确保maven-compiler-plugin未禁用注解处理：删除-proc:none、避免skip，显式配置annotationprocessorpaths指定处理器路径，并可选通过compilerargs传入自定义参数。
要在 Maven 中通过 maven-compiler-plugin 正确启用注解处理器（APT），核心是让编译器在 javac 阶段识别并运行注解处理器，而不是跳过或禁用它。默认行为在较新版本中已较友好，但显式配置才能确保稳定生效，尤其在多模块、混合依赖或使用 Lombok/MapStruct 等工具时。
确保注解处理未被禁用
这是最容易被忽略却最关键的一点：必须确认没有主动关闭 APT 机制。
- 检查是否误配了
<compilerargument>-proc:none</compilerargument>—— 这会彻底禁用所有注解处理，需删除或注释掉 - 避免设置
<skip>true</skip>或<skipmain>true</skipmain>，否则整个编译阶段（含注解处理）都会被跳过 - 如需明确控制处理模式，可选配：
-proc:full（默认，先处理注解再编译）、-proc:only（仅处理注解，不生成 class 文件）
显式声明 annotationProcessorPaths（推荐做法）
当注解处理器（如 lombok、mapstruct-processor）不应作为运行时依赖引入时，应通过 annotationProcessorPaths 单独指定，避免污染 compile 范围。
- 路径中每个
<path></path>对应一个包含META-INF/services/javax.annotation.processing.Processor的 jar - 适用于多模块项目中处理器位于独立 module 的场景，也利于构建隔离
- 示例配置片段：
配合 compilerArgs 传递自定义参数（按需）
部分高级处理器（如 ErrorProne、Checker Framework）需要额外命令行参数才能启用特定检查或行为。
- 使用
<compilerargs></compilerargs>列表传入，每项为完整参数字符串 - 注意参数格式需与 javac 兼容，例如：
-Xplugin:ErrorProne、-AdisableWarnings=true - 多个参数用空格分隔，也可拆成多行提高可读性
验证是否生效的简单方式
配置完成后，可通过以下方式快速确认注解处理器已实际运行：
- 执行
mvn compile -X查看 debug 日志，搜索AnnotationProcessor或处理器类名（如LombokProcessor） - 对使用
@Data的类，检查target/generated-sources/annotations/下是否生成了对应源文件（Lombok 默认不落盘，但 MapStruct 会生成*MapperImpl.java） - 故意写错注解用法（如
@Mapper缺少componentModel），观察是否报出处理器专属错误而非编译错误
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
