Java类与对象属性命名遵循小驼峰命名法、语义清晰原则,boolean属性优先用isXxx前缀,私有属性配public访问器,常量用全大写加下划线。

Java 中类与对象的属性命名,核心是遵循 驼峰命名法(camelCase) 和 语义清晰、可读性强 的原则,同时配合访问修饰符体现封装意图。这不是随意约定,而是被 JDK 源码、主流框架(如 Spring、Apache Commons)、Google Java Style Guide 及多数企业项目广泛采纳的实践。
基本命名规则:小驼峰 + 名词性表达
属性名必须以小写字母开头,后续单词首字母大写,整体为一个有意义的名词或名词短语:
-
正确示例:
userName、maxRetryCount、isAvailable、httpClient、xmlDecoder -
错误示例:
UserName(大驼峰,属类名风格)、user_name(下划线,非 Java 常规)、uName(缩写模糊)、getUserName(这是方法名,不是属性)
布尔类型属性:优先用 isXxx 前缀
对于 boolean 类型的属性,推荐以 is 开头(而非 has、can 等),尤其当它参与 JavaBean 规范时(如被 Introspector 解析、用于 JSP EL 或 Jackson 序列化):
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
private boolean isActive;→ getter 自动识别为isActive() -
private boolean hasPermission;→ 虽语义合理,但不被标准 Bean 工具默认识别为属性访问器(需额外配置) - 注意:
is前缀仅适用于boolean,不可用于Boolean包装类(因可能为null),此时建议用status或明确语义名如activationStatus
私有属性 + 公共访问器:封装是默认前提
除非明确需要包内共享或性能敏感场景,否则属性应声明为 private,并通过 public 的 getter/setter 方法控制访问:
立即学习“Java免费学习笔记(深入)”;
-
private String email;→ 对应getEmail()/setEmail(String email) - 若属性只读(如初始化后不可变),可只提供 getter,setter 省略或抛
UnsupportedOperationException - 避免
public字段 —— 它破坏封装,无法在赋值时校验、触发事件或做兼容处理
常量与静态属性:全大写 + 下划线分隔
使用 static final 声明的常量(包括字面量、枚举实例、不可变对象引用)必须全大写,单词间用下划线连接:
public static final int DEFAULT_PORT = 8080;private static final String SQL_INSERT_USER = "INSERT INTO user ...";- 注意:
final字段若为对象引用(如final List<String> NAMES),仅保证引用不可变,内容仍可修改 —— 如需真正不可变,应使用Collections.unmodifiableList或ImmutableList

















