Java变量命名需遵循四大原则:使用准确表意的英文单词组合,严格采用小驼峰命名法,布尔变量以is/has/can/should开头,避免关键字、数字开头及特殊符号。

Java 变量命名不是“随便起个名就行”,而是直接影响代码是否易读、易改、易协作的关键细节。名字写对了,别人(包括三个月后的你自己)一眼看懂意图;写错了,轻则多花几分钟猜逻辑,重则引发隐藏 bug。
使用有意义的英文单词组合
变量名应准确反映其用途,避免单字母(如 a、tmp)、缩写不明(如 usrNm)或拼音(如 yonghu)。优先选完整、常用、无歧义的英文词。
- 推荐:userName、maxRetryCount、isEmailValid
- 不推荐:un(含义模糊)、cnt(非通用缩写)、str1(无业务语义)
严格遵守驼峰命名法(camelCase)
Java 社区约定:局部变量、字段、方法名统一用小驼峰——首字母小写,后续单词首字母大写,不加下划线、不混用大写缩写。
- 正确:httpStatusCode、xmlParser、userIdList
- 错误:HTTPStatusCode(大驼峰是类名用)、user_name(含下划线)、XMLParser(全大写缩写破坏可读性)
布尔变量以 is/has/can/should 开头
这是 Java 中最被忽视也最有价值的习惯之一。以助动词开头能立刻表明类型和语义,让条件表达式接近自然语言。
立即学习“Java免费学习笔记(深入)”;
- 清晰:isValid → if (isValid);hasPermission → if (hasPermission)
- 混乱:valid → if (valid)(看不出是布尔);permission → if (permission)(类型与语义双模糊)
避免关键字与保留字,慎用数字和特殊符号
变量名不能是 Java 关键字(如 class、int、return),也不建议以数字开头或混入 $、_(除极少数框架生成代码外)。
- 安全:userCount2024(数字在后,可接受)、apiTimeoutMs
- 风险:2ndAttempt(编译报错)、classType(含关键字 class)、user_name(下划线违反规范)


















