Java类命名须大驼峰且与文件名严格一致;包名全小写;字段优先private final;构造函数禁业务逻辑,用构造器注入;方法遵循单一职责,参数少而语义清。
类名必须用大驼峰,且与文件名严格一致
Java编译器强制要求 public 类的名称必须和文件名完全相同(包括大小写),否则编译失败。比如定义了 public class HttpClientUtil,就必须保存在 HttpClientUtil.java 中;若误写成 httpclientutil.java 或 HttpClientutil.java,javac 会报错 class HttpClientUtil is public, should be declared in a file named HttpClientUtil.java。
非 public 类可以和文件名不一致,但不建议——这会让团队成员难以定位类,IDE 也无法正确索引。
- 包名全小写(如
com.example.order),避免下划线或大写字母 - 类名体现职责,避免模糊词如
Manager、Helper、Tool(除非确实只做单一工具方法) - 接口名也用大驼峰,通常以形容词或名词结尾(如
Runnable、OrderRepository),避免加I前缀(那是 C# 风格)
字段优先私有 + final,暴露用 getter 而非 public 字段
直接暴露 public 字段会破坏封装,导致外部随意修改、无法添加校验逻辑、难以调试变更来源。哪怕只是 public static final String VERSION = "1.2" 这种常量,也建议统一用 public static final + 大写下划线命名,且确保不可变。
实例字段几乎都该是 private,需要读取时提供 getXXX() 方法;如果字段本身是可变对象(如 List、Map),getter 必须返回副本(如 new ArrayList(this.items)),否则外部仍能修改内部状态。
立即学习“Java免费学习笔记(深入)”;
-
private final是首选组合:明确表达“初始化后不变”,JVM 也能更好优化 - 布尔字段不要用
isXXX()命名却返回非布尔值,否则 Jackson、Spring 等框架反射解析会出错 - 避免为每个字段机械生成 getter/setter:只暴露真正需要被外部访问的属性
构造函数只做必要初始化,拒绝业务逻辑和远程调用
构造函数里执行 HTTP 请求、数据库查询、文件读取等操作,会导致 new 对象失败风险高、单元测试难 mock、类生命周期失控。例如 new OrderService() 内部去连 Redis,那所有单元测试都会因网络失败而挂掉。