java变量命名需合法且得体:以字母、_或$开头,禁数字开头和关键字;统一小驼峰(如httpstatuscode);常量全大写下划线(如max_retry_count);布尔变量用is/has等前缀(如isactive);集合用复数(如users)。

Java 变量命名要同时满足编译通过和团队可读,核心是“合法 + 得体”。不合规会报错,不得体会让人反复猜意图。
基础语法必须过关
变量名只能以字母、下划线(_)或美元符($)开头,后面可接字母、数字、_ 或 $;不能以数字开头。例如:
✅ userName、_count、$cache
❌ 1stAttempt(数字开头)、class(关键字)、user-name(含连字符)
Java 区分大小写,userId 和 userid 是两个不同变量。
推荐统一用小驼峰命名法
首单词全小写,后续每个单词首字母大写,不用下划线、空格或连字符:
- ✅ httpStatusCode、isAvailable、maxRetryCount
- ❌ http_status_code(下划线风格,适合常量)、HttpStatusCode(大驼峰,是类名风格)、username(多词边界模糊,易误解为单个词)
按变量类型区分命名习惯
局部变量与实例变量:一律小驼峰,强调语义清晰。
✅ orderTotal、userRepository、httpClient
❌ tmp、val、usrNm(非通用缩写)
常量(public static final):全大写 + 下划线分隔,且必须是编译期常量。
✅ MAX_RETRY_COUNT、DEFAULT_TIMEOUT_MS
⚠️ 注意:final String apiKey 是实例常量,仍按变量规则写成 apiKey,不是 API_KEY
布尔变量:强制用 is / has / can / should 等前缀,一眼识别真假含义。
✅ isActive、hasPermission、canEdit
❌ flag、status、result(完全无法判断语义)
实用细节别踩坑
- 避免用 _ 或 $ 开头,这类名字常被框架或编译器内部占用
- 集合/数组变量建议用复数形式:users、fileNames、configurations
- 不要为省字符随意缩写,只接受行业通用缩写:如 url、id、http、json、dao、dto
- IDE 建议启用 Alibaba Java Coding Guidelines 插件,实时提示不规范命名
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











