java变量命名须用小驼峰(如userlogincount),布尔变量强制加is/can/has前缀(如isactive),禁用缩写、模糊词及下划线;常量仅public static final基本类型或不可变对象可用全大写下划线(如max_retry)。

Java 变量在类设计中必须统一使用小驼峰命名法(lowerCamelCase),这是提升代码规范性的基础动作,不是风格偏好,而是工程落地的硬性要求。
变量名必须准确表达语义
命名要让人一眼看懂用途,避免模糊词、缩写或通用词。变量是数据的“标签”,不是代号。
- ✅ 推荐:userLoginCount、isEmailVerified、maxRetryAttempts
- ❌ 避免:ulc(含义不清)、flag(无法判断状态)、data(完全无上下文)
- 名词或名词短语优先:如 shoppingCartTotalPrice 比 total 更具业务指向性
布尔变量强制加 is/can/has 前缀
这是 JavaBean 规范和团队协作的关键约定,能明确区分状态型变量与普通属性,也方便框架自动识别(如 Spring、Jackson)。
- ✅ 推荐:isActive、hasPermission、canEdit、shouldRetry
- ❌ 避免:active(易被当作普通数值或字符串)、permissionFlag(冗余且非标准)
- 注意:getter 方法会自动映射为 isXXX() 或 getXXX(),前缀不一致会导致序列化/反射异常
严格区分大小写与分隔方式
小驼峰的核心是“首词全小写 + 后续单词首字母大写 + 零分隔符”。下划线、连字符、空格、数字开头、中文、美元符等均不符合规范。
- ✅ 正确:httpResponseCode、userName、xmlParser、isExpired
- ❌ 错误:user_name(下划线属 Python 风格)、UserName(大驼峰是类名)、3rdParty(数字开头非法)、用户名称(中文破坏跨平台兼容性)
- IDE(如 IntelliJ)默认对下划线变量标黄;部分 Checkstyle/PMD 规则直接报错
常量与非常量必须泾渭分明
只有 public static final 且类型为基本类型或不可变对象(如 String、LocalDate)时,才允许用全大写+下划线(SCREAMING_SNAKE_CASE)。
- ✅ 正确:public static final int MAX_RETRY = 3;、private static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
- ⚠️ 注意:final String apiKey; 是实例常量,仍按变量规则写成 apiKey,不是 API_KEY
- ❌ 错误:static Map
cacheMap; 即使加了 final,只要不是 public static final,就不算常量,不能用全大写
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











