Java类的字段必须声明在类的大括号内、所有方法之外；写在方法内是局部变量，非类成员。实例字段不加static，静态字段加static；建议用private修饰并配getter/setter。
Java类里字段写在哪儿才算“属于这个类”
字段（Field）必须声明在类的大括号 {} 内、所有方法之外，否则编译直接报错 illegal start of expression。写在方法里就是局部变量，生命周期和作用域都完全不同。
常见错误：把 String name; 错误地放在 public void print() { ... } 里面——它就不再是类的属性，不能被其他方法访问，也不能用 this.name 引用。
- 实例字段不加
static，每个对象一份副本 - 静态字段加
static，整个类共用一份，注意多线程下可能被并发修改 - 字段建议用
private修饰，靠getter/setter控制访问，别图省事设成public
方法签名里哪些部分决定它能不能被重载或重写
重载（Overload）看的是「方法名 + 参数列表」，和返回值类型、异常声明、static 或 final 修饰符都无关；重写（Override）则要求方法名、参数列表、返回类型（协变除外）、异常声明（子类不能抛更宽泛的异常）全部匹配，且访问权限不能更严格。
典型踩坑：void setName(String name) 和 String setName(String name) 在同一个类里是非法的——仅返回值不同，不构成重载，编译失败 method xxx is already defined。
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 重载发生在同一个类中；重写发生在父子类之间
-
@Override注解不是可选的装饰，它是编译器检查手段，漏加可能导致你以为重写了，其实只是新定义了一个方法 - 构造方法不能被重写（没有继承关系），但可以重载
为什么 private 字段也能被同包内其他类“间接访问”
因为 Java 的访问控制是基于类（class）而非对象（instance）。只要两个类在同一个包里，即使字段是 private，也能通过反射绕过检查——但这不是设计本意，而是 JVM 层面的宽松策略。正常编码中，private 就意味着只能在本类内部访问。
真正影响可见性的只有四个修饰符：private、默认（包级）、protected、public。别指望靠 private 防住反射，也别误以为 protected 能跨包访问非子类。
- 子类跨包时，
protected字段只能被继承后访问，不能通过父类引用直接点出来 -
default（不写修饰符）字段可在同包任意类中通过对象引用访问，比如obj.fieldName - 字段加
final后必须在声明、构造块或构造方法中完成初始化，否则编译报错variable xxx might not have been initialized
IDE 自动生成 getter/setter 时容易忽略的细节
IntelliJ 或 Eclipse 点几下就能生成 getName() 和 setName(String name)，但默认逻辑往往不够健壮——比如没做空值校验、没处理不可变集合、没考虑线程安全。
例如对 List<string></string> 类型字段，自动生成的 getList() 如果直接返回内部引用，外部就能绕过 setter 修改原始数据，破坏封装性。
- 返回集合字段时，应返回不可修改视图：
Collections.unmodifiableList(this.items) - 接收集合参数的 setter，应做防御性拷贝：
this.items = new ArrayList(items) - 基本类型包装类（如
Integer）字段的 getter，不要盲目判空再拆箱，避免NullPointerException
@Data 看似省事，但字段访问逻辑全被隐藏了，出问题时反而更难定位。 
