public 和 private 在类成员上的行为差异

它们控制的是「谁能在哪访问」，不是「能不能用」。public 成员可以从任何地方被访问，只要能拿到对象引用或类名；private 成员只能在定义它的那个类内部访问，连子类、同包其他类都不行。

• 子类继承 public 方法可直接调用；继承 private 方法则完全不可见——编译器会报 cannot find symbol
• 同包下其他类能访问 public 字段，但对 private 字段连读都做不到，更别说修改
• private 构造方法意味着外部无法 new 实例，常用于单例或工厂模式；public 构造方法则是默认开放创建入口

什么时候该用 private 而不是 public

核心原则：只要不明确需要对外暴露，就优先设为 private。这不是保守，而是防止后续误用和意外耦合。

• 字段几乎都应该 private，哪怕只是临时存个值——否则别人可能绕过你的逻辑直接改状态
• 工具方法（比如 parseDate()、isValidEmail()）如果只在本类内调用，就别设成 public，避免被外部当成稳定 API 依赖
• 测试代码里故意访问 private 成员？别用反射硬搞，要么加 package-private（不写修饰符），要么提供 public 的测试友好的 getter/setter

常见编译错误与定位方式

出错时别急着加 public，先看错误信息是否指向访问位置是否合法。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 错误 error: cannot access XXX + 提示 private —— 检查是不是在非定义类中试图访问了 private 成员
• 错误 error: method XXX() is not public in YYY; cannot be accessed from outside package —— 这其实是 package-private（默认修饰符）被跨包调用了，不是 private 的锅
• IDE 显示灰色/不可点击的 private 方法？那是正常现象，不代表代码有问题，只是说明它没被外部引用

public class 和 private class 的限制

类级别的 public 和 private 约束完全不同，而且非常严格。

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

• 一个源文件里最多只能有一个 public class，且文件名必须和它完全一致（大小写敏感），否则编译失败
• 不能有 private class 作为顶层类——编译器直接拒绝，会报 modifier private not allowed here
• 但可以有 private 的内部类（inner class），比如 private static class Helper，这种只在外部类内部可用，适合封装辅助逻辑

Java 的访问控制不是靠“写得全”来保证安全，而是靠“收得紧”来减少意外。最容易被忽略的是：字段不加修饰符不是“默认 public”，而是 package-private，它比 private 宽松得多，也比 public 隐蔽得多——很多问题其实出在这里。