Java访问修饰符是定义API边界的最基础机制:public明确暴露契约并配Javadoc;优先用package-private保护实现细节;protected仅用于明确继承扩展;private封死所有无关内部逻辑。

Java 中访问修饰符是定义 API 边界最直接、最基础的机制。写得清晰,能让人一眼看出“哪些该用、哪些不该碰”,减少误用和耦合;写得模糊,就会导致内部逻辑外泄、测试困难、升级踩坑。
用 public 明确暴露契约,而非实现
只对真正需要被外部模块调用的方法或类加 public,且必须配套 Javadoc 说明用途、参数含义、返回值约定、异常场景。避免“先 public 再补文档”的习惯。
- 接口方法、SPI 入口点、框架回调方法 —— 必须 public,但仅限契约本身
- 工具类中供业务复用的静态方法(如
StringUtils.isEmpty())—— 可 public,但需确保无副作用、线程安全 - 不要为测试方便把内部方法设为 public;用
@VisibleForTesting注解 + package-private 更合适
优先用 package-private(默认)保护实现细节
不加任何修饰符即为 package-private,这是 Java 最被低估却最实用的边界控制方式。它天然限制在模块/包内可见,适合:
- 辅助类、Builder、DTO 的构造器和 setter —— 外部不应 new 或改状态
- 策略实现类、模板方法的钩子方法 —— 仅被同包内的核心类调用
- 测试时可通过同包结构直接访问,无需反射或 mock,也无需降级访问权限
谨慎使用 protected:只留给明确的继承扩展场景
protected 不是“比 private 宽松一点”的默认选择,而是发出强信号:“我预期子类会重写这个方法”或“我提供钩子供继承定制”。滥用会导致:
立即学习“Java免费学习笔记(深入)”;
- 子类意外依赖非稳定实现逻辑(比如重写了不该重写的模板步骤)
- 父类无法安全重构内部流程(因 protected 方法可能被外部继承链调用)
- 建议:只在抽象基类中为可扩展行为声明 protected 方法,并在 Javadoc 中写明“子类可重写”及约束条件
用 private 封死所有无关变量与辅助逻辑
字段、工具方法、缓存容器、临时计算逻辑 —— 只要不参与对外契约,一律 private。尤其注意:
- 避免 public 类中出现 public 字段(哪怕是 final),改用 private + getter
- 内部类若仅被外围类使用,就设为 private static class
- lambda 引用的方法若只在本类内使用,方法本身应 private,而非 package-private
访问修饰符不是语法装饰,而是 API 设计的语言。每写一个 public,都要问一句:这个契约未来三年还稳吗?每留一个 package-private,都是在说:这里属于这个模块的呼吸节奏。不复杂,但容易忽略。


















