package.getannotation() 可获取 package-info.java 中的包级注解，前提是注解保留策略为 retentionpolicy.runtime 且正确定义在 package-info.java 中；否则返回 null。
Java 中 Package.getAnnotation() 可以直接获取 package-info.java 中声明的包级注解，但前提是该注解必须满足两个关键条件：**保留策略为 RetentionPolicy.RUNTIME**，且**在 package-info.java 中正确定义**。
确保注解具有 RUNTIME 保留策略
只有运行时可见的注解才能通过反射获取。如果自定义注解的 @Retention 是 CLASS 或 SOURCE，getAnnotation() 将始终返回 null。
正确写法示例：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PACKAGE)
public @interface MyPackageAnnotation {
String value() default "";
}
在 package-info.java 中正确声明注解
包级注解必须写在 package-info.java 文件中，且位于 package 声明之前（或之后，但需在同一文件），不能放在其他类文件里。
例如，在 com.example.myapp 包下创建 package-info.java：
@MyPackageAnnotation("this is a package annotation")
package com.example.myapp;
// 注意：这里不能有 import 或 class 声明
// package-info.java 只能包含包声明、Javadoc 和包级注解
使用 Package.getAnnotation() 获取
通过 Class 对象或 ClassLoader 获取对应包的 Package 实例，再调用 getAnnotation()：
- 方式一：从已有类获取其所在包
MyClass obj = new MyClass(); Package pkg = obj.getClass().getPackage(); // 获取 MyClass 所在包 MyPackageAnnotation ann = pkg.getAnnotation(MyPackageAnnotation.class); // ✅ 正确
- 方式二：通过 ClassLoader 显式加载包（适用于无类可用时）
Package pkg = Package.getPackage("com.example.myapp");
MyPackageAnnotation ann = pkg.getAnnotation(MyPackageAnnotation.class); // ✅ 有效（前提是包已被加载）
注意：如果包从未被加载（比如该包下没有任何类被初始化或引用），Package.getPackage() 可能返回 null。此时建议优先使用方式一，依托已加载的类来获取包信息。
常见问题排查
-
返回 null？ 检查注解是否加了
@Retention(RetentionPolicy.RUNTIME)，以及package-info.java是否在正确路径、已编译进 classpath。 -
编译报错“package-info.java cannot be used to declare classes”？ 确保文件中没有
class、interface或import语句 ——package-info.java是特殊文件，只允许包声明、Javadoc 和包级注解。 -
IDE 不识别或未编译 package-info.java？ 确认构建工具（Maven/Gradle）配置正常，且该文件位于
src/main/java对应包路径下（如src/main/java/com/example/myapp/package-info.java）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
