Java变量命名需语义优先、风格统一，声明位置须按作用域精准落位，逻辑结构应服务于流程而非堆砌数据，类型与语义必须一致，且须规避常见误用。
Java变量命名不是语法检查通过就行，而是代码可读性、协作效率和长期维护的起点。命名要让别人（包括三个月后的你自己）一眼看懂“它是什么、干什么、在哪用”，逻辑结构则决定了变量该出现在哪、生命周期多长、能不能被复用。
变量命名：语义优先，风格统一
命名核心是传递明确意图，而不是节省字符：
- 用完整单词，避免歧义缩写：✅userLoginCount、isEmailVerified、maxRetryAttempts；❌ulc、emailVerf、retryMax
- 布尔变量加 is_、has_、can_ 前缀：✅isActive、hasPermission；❌active（状态还是动作？）、permission（名词无法表达真假）
- 严格遵守小驼峰（lowerCamelCase）：✅firstName、httpStatusCode；❌first_name（Python风格）、FirstName（类名风格）
- 常量全大写+下划线：✅DEFAULT_TIMEOUT_MS、MAX_UPLOAD_SIZE_BYTES；❌defaultTimeoutMs、MaxUploadSize
- 避开雷区：不以数字开头（2ndAttempt❌ → secondAttempt✅），不覆盖内置名（list❌、str❌），不用关键字（class❌、return❌）
声明位置：按作用域精准落位
变量在哪声明，直接影响它的可见范围、初始化时机和内存生命周期：
- 局部变量：在方法/代码块内声明，必须显式初始化，作用域最小、最安全。例如循环计数器 i 可接受，但业务变量 data 必须改名如 userData
- 实例变量：在类中、方法外声明，每个对象独有一份，默认有初始值（null、0、false），命名用小驼峰，如 orderStatus、lastLoginTime
- 静态变量：用 static 修饰，属于类而非实例，适合配置或共享状态；若为常量，必须加 final 并用全大写下划线，如 public static final int RETRY_LIMIT = 3;
- 禁止遮蔽：局部变量不能与同作用域的参数或字段重名，否则会掩盖（shadow）原变量，引发逻辑错误
逻辑结构：变量服务于流程，而非堆砌数据
变量是程序逻辑的“零件”，它的存在要有明确目的：
立即学习“Java免费学习笔记（深入）”；
- 一个变量只代表一个概念：不要用 result 承载多种含义，不同场景应分设 validationResult、apiResponse
- 及时释放作用域：方法内临时计算结果，用完即弃；避免把本该局部的变量提升为成员变量来“图方便”
- 避免魔法值：数字、字符串直接出现时，必须封装为命名变量或常量。比如 if (status == 2) ❌ → if (status == OrderStatus.CONFIRMED.code()) ✅
- 类型与语义一致：用 LocalDateTime 而非 long 存时间戳，用枚举而非整数表示状态，让变量自身携带业务含义
实战避坑：常见误用与修正
这些细节看似微小，却高频导致理解成本上升或运行时异常：
- POJO 中布尔字段别加 is 前缀：定义 private Boolean deleted;，对应 getter 是 isDeleted()，但某些框架（如 MyBatis、Dubbo）会误解析为字段名 deleted，导致映射失败 → 应改为 private Boolean deleted; + getDeleted()
- 数组声明推荐 int[] arr，而非 int arr[]：前者强调“这是一个 int 数组”，类型信息前置，更符合 Java 语义习惯
- 包名全小写、单词连写：✅com.example.auth；❌com.example.AuthService（大小写混用）、com.example.auth_service（下划线）
- 杜绝编号命名：❌user1、user2、tempData1；应重构为有业务意义的集合或独立对象
