核心是让方法只对真正需要它的代码可见——不是靠信任，而是靠编译器和运行时的强制拦截；优先用private收窄入口，protected需配套契约文档，public只暴露稳定业务契约，default限于模块内协作并警惕包名冲突。

核心是让方法只对真正需要它的代码可见——不是靠信任，而是靠编译器和运行时的强制拦截。可见性设得越宽，越容易被误用、滥用或绕过业务逻辑。

优先用 private，把入口收窄到最小范围

绝大多数工具方法、状态校验逻辑、内部状态变更操作，都不该被外部触碰。声明为 private 后，连同包类、子类、反射（默认情况下）都无法直接调用，从源头切断非法路径。

• 字段初始化辅助方法、JSON 序列化前的数据清洗逻辑、密码哈希计算封装——这些都该是 private
• 避免“先 public 再改 private”的惯性：一旦暴露，下游可能已形成强依赖，后续收缩会引发编译失败或运行时异常
• private 方法可自由重构参数、重命名、拆分合并，不影响任何外部代码

子类扩展点慎用 protected，必须配套契约文档

protected 不是“给子类用的快捷通道”，而是明确开放继承契约的信号。它允许跨包子类访问，风险远高于 package-private。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 禁止仅因“以后可能要继承”就提前设为 protected；没有当前继承需求，一律用 private 或 default
• 若确需 protected 方法（如模板方法中的钩子），必须在 Javadoc 中写清：输入约束（如“不允许 null”）、是否线程安全、是否有副作用（如修改共享状态）、是否允许重入
• 更安全的替代：用 abstract 方法 + final 模板方法，把流程控制权完全交给父类，子类只能实现规定动作，无法跳过校验或乱序调用

对外暴露接口用 public，但只暴露契约，不暴露实现

public 方法是类与外界的正式协议，它的签名和行为必须稳定。不要因为“方便调试”或“临时支持”而加 public 工具方法。

立即学习“Java免费学习笔记（深入）”；

• 所有 public 方法必须有明确业务语义（如 withdraw(double amount)），而非技术动作（如 updateBalanceDirectly(double newBalance)）
• 拒绝裸字段 setter：setBalance() 必须校验金额非负、不超信用额度、触发审计日志；若允许绕过规则，说明设计本身已失守
• 返回值做防御性复制：public 方法若返回集合或数组，用 Collections.unmodifiableList() 或 List.copyOf()，防止外部修改影响内部状态

包内协作用默认权限（package-private），但警惕模块边界失效

default 权限适合同一业务模块内的类协同，比如 DAO 层与实体类之间、策略实现与上下文之间的调用。但它不防同名包的“伪同包”访问。

• Maven 多模块项目中，不同 module 若声明相同 package，它们能互相访问 default 成员——这不是设计意图，而是 classloader 的妥协
• JDK 9+ 环境下，应配合 module-info.java 使用：exports com.example.core; 仅导出 API 包，com.example.internal 包不 exports，即使类是 public，其他模块也无法 import 或 new
• JDK 8 及以下，可用静态工厂 + 接口返回 + 私有实现类组合：工厂方法是 public，但返回的是 interface，具体 class 设为 package-private 或 private static class，外部连类名都拿不到