Java封装通过private字段+public getter/setter提供可控访问接口，支持校验、扩展、框架兼容及语义表达，仅在不可变纯数据容器等极少数场景才可暴露public字段。
属性直接暴露（public 字段）和通过 getter/setter 方法访问，本质是封装策略的选择问题。核心不是“该不该加方法”，而是“是否需要控制访问”。
什么时候可以暴露 public 字段
仅限于以下情况：
- 类是纯数据容器，且字段值绝对不可变、无业务含义（如
Point{x, y}、Range{min, max}这类不可变结构体） - 字段是
final且初始化后永不改变，且无需校验或转换逻辑 - 性能极端敏感场景（如高频数值计算中间对象），且已确认框架兼容性（如 Jackson 默认不序列化 public 字段，需额外配置）
为什么多数情况下应优先用 getter/setter
它们提供可控的访问入口，带来实际收益：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
校验能力：在
setAge(int age)中可拦截非法值（如负数、超大值），而public int age无法阻止外部直接赋值 - 行为扩展空间：后续加日志、缓存刷新、事件通知等逻辑，只需改方法内部，调用方完全无感
- 框架兼容性：Spring、Jackson、MyBatis 等主流框架默认依赖 JavaBeans 规范（即 getter/setter），直接暴露字段常导致绑定失败或序列化异常
-
语义清晰：比如
isRunning()比getRunning()更符合布尔属性表达习惯，框架也能正确识别
getter/setter 不必机械成对出现
封装的目标是控制，不是凑数：
- 只读字段（如主键
id）只提供getId()，不写setId() - 计算属性（如
getFullName()）可不对应真实字段，内部拼接逻辑可随时调整 - 敏感字段（如
passwordHash）可只提供 setter（用于注入），不提供 getter（防止意外泄露）
慎用 @Data 等全量生成注解
Lombok 的 @Data 会无差别为所有字段生成 getter/setter/toString/equals/hashCode，容易破坏边界：
- 临时状态字段（如
retryCount）被暴露，可能干扰序列化或比较逻辑 - 敏感字段（如
token）出现在toString()中，日志里直接泄露 - 建议用
@Getter+@Setter显式标注真正需要暴露的字段
