getFields()返回当前类及其可访问父类中所有public字段(含static和instance),不包括protected、private及包级字段;getDeclaredFields()仅返回当前类声明的所有字段(含private等),不含父类字段。

Class.getFields() 方法只返回当前类及其父类中所有 public 的字段(即 public 属性),但仅限于 非私有、非静态、非 final 修饰的成员变量 —— 实际上,它只返回 public 成员变量,不管是否 static 或 final,只要被声明为 public 就会包含在内。
getFields() 返回哪些字段?
该方法返回的是当前 Class 对象所表示的类及其所有**可访问的父类/接口**中,所有被声明为 public 的字段(包括 static 和 instance 字段),前提是这些字段没有被 private 修饰,且能被当前调用者访问(即遵循 Java 访问控制规则)。
- 只返回 public 字段,private、protected、package-private 字段均不返回
- 包括 static public 字段(如
public static String NAME;) - 包括 public instance 字段(如
public int id;) - 不会返回任何方法、构造器、内部类或注解
- 如果父类中有 public 字段,也会被包含(只要该父类是可访问的)
和 getDeclaredFields() 的区别
getFields() 是“向上可见”的:它只看 public,且跨继承链;而 getDeclaredFields() 是“本类专属”的:返回当前类声明的所有字段(无论访问修饰符),但不包括父类字段。
-
getFields()→ 所有 public 字段(本类 + 父类 + 接口中的 public static final 常量) -
getDeclaredFields()→ 仅本类定义的字段(public / protected / package / private),不含继承来的
简单使用示例
假设有一个类:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记(深入)”;
public class Person {
public String name;
public static final int MAX_AGE = 150;
protected String email;
private int salary;
}
调用 Person.class.getFields() 会返回:
-
public String name(public instance 字段) -
public static final int MAX_AGE(public static final 常量,接口中定义的 public static final 字段也会被包含)
注意:email(protected)和 salary(private)都不会出现。
获取后怎么安全使用?
拿到 Field 数组后,若要读写实例字段,需注意:
- 对 non-static 字段,需要用具体对象调用
field.get(obj) - 对 static 字段,传
null即可:field.get(null) - 如果字段是 final 且已被初始化,
set()可能抛出IllegalAccessException(JDK 9+ 默认禁止修改 final 字段) - 必要时可先调用
field.setAccessible(true)—— 但这对 public 字段通常不需要,因为它们本来就是可访问的

















