messager 是 java 编译期注解处理器中用于输出诊断信息的标准工具，通过 processingenvironment 获取；支持 error（中断编译）、warning（不中断）、note 和 mandatory_warning 类型，推荐关联 element 定位并提供明确提示。
在 Java 编译期注解处理器中，Messager 接口是标准的、用于向编译器输出诊断信息（如错误、警告、提示）的工具。它由 ProcessingEnvironment 提供，确保信息能被正确集成到编译流程中（例如出现在 IDE 的问题视图或命令行编译输出里）。
获取 Messager 实例
注解处理器中不能直接 new Messager，而是通过 ProcessingEnvironment 获取：
示例代码：
@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
Messager messager = processingEnv.getMessager();
// 后续使用 messager 输出信息
}
用 Messager 输出错误（ERROR）
调用 printMessage(Diagnostic.Kind.ERROR, ...) 触发编译失败，中断后续处理。通常配合 Element 定位出错位置，提升可读性。
- 推荐传入具体的
Element（如出问题的类、字段），让错误定位到源码行 - 消息字符串应清晰说明问题原因和修复建议
- 不要只写“error occurred”，要具体，比如“@BindView field must be non-private”
示例：
messager.printMessage(
Diagnostic.Kind.ERROR,
"@Route path cannot be empty",
element // 假设 element 是标注了 @Route 的类或方法
);
用 Messager 输出警告（WARNING）
使用 Diagnostic.Kind.WARNING 不会中断编译，但会在构建日志中标记为警告，适合提示潜在问题（如过时用法、非强制约束）。
- 同样建议传入关联的
Element，便于开发者快速定位 - 避免滥用警告——太多警告会降低可信度；只对真正值得留意的情况发出
- 可结合
@SuppressWarnings或自定义注解支持静默机制（需额外解析）
示例：
messager.printMessage(
Diagnostic.Kind.WARNING,
"Using deprecated @InjectView; prefer @BindView",
element
);
其他常用类型与技巧
Messager 还支持 NOTE 和 MANDATORY_WARNING：
-
NOTE：用于提示性信息（如生成了某个类），不影响编译，常用于调试或确认行为 -
MANDATORY_WARNING：语义上比普通 warning 更强，但实际效果与 WARNING 相同（JDK 中未强制区分） - 所有消息都支持格式化字符串（类似
String.format），但注意避免 null 引用导致 NPE - 不建议在循环中高频调用，尤其 ERROR —— 可能触发重复报错，考虑合并判断逻辑
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
