Java变量命名须用小驼峰且见名知意,如userName;常量用全大写下划线,如MAX_RETRY;布尔变量加is/has等前缀,如isLoaded;禁用非通用缩写,如usrNm。

Java 变量命名不是随便起个名字就行,它直接关系到代码是否易读、可维护、能被团队快速理解。核心就一条:用小驼峰(lowerCamelCase),且必须见名知意。
变量名必须用小驼峰
首单词全小写,后续每个单词首字母大写,单词之间不加空格或下划线。
- ✅ 正确:userName、httpStatusCode、isAvailable、maxRetryCount
- ❌ 错误:user_name(含下划线)、UserName(大驼峰,是类名风格)、username(多词时边界模糊,不推荐)
常量才用全大写下划线
仅限 public static final 修饰的编译时常量。
- ✅ 正确:public static final int MAX_RETRY = 3;
- ✅ 正确:private static final String DEFAULT_CHARSET = "UTF-8";
- ⚠️ 注意:哪怕只是 final String apiKey(实例常量),也得按变量规则写成 apiKey,不能写成 API_KEY
布尔变量要带语义前缀
用 is / has / can / should 等动词开头,让真假含义一目了然。
立即学习“Java免费学习笔记(深入)”;
- ✅ 推荐:isLoaded、hasPermission、canEdit、shouldRetry
- ❌ 避免:flag、status、result(完全看不出真假含义)
别缩写,除非是通用缩略词
缩写会增加认知负担,尤其对新成员或跨团队协作。
- ✅ 清晰:productCount、httpClient、userRepository、orderId
- ✅ 行业通用缩写:url、id、http、xml、json、dao、dto、api(这些已被广泛接受)
- ❌ 拒绝:usrNm(user name)、tmpStr(tempString)、cnt(count)、cfg(config)——除非整个项目统一且文档化


















