Java变量命名需兼顾合法性与可读性，采用小驼峰法（如userName）、布尔变量以is/has开头，禁用模糊简写和下划线分隔，通过速查表、IDE检查及Code Review保障团队一致性。
Java 变量声明与命名的一致性管理，核心在于让每个变量名既合法又“说得清、看得懂、改得稳”。它不是靠死记硬背规则，而是建立一套可执行、可检查、团队共用的轻量级习惯。
变量名必须合法且可读
合法性是底线，可读性是目标。两者缺一不可。
- 变量名只能由字母、数字、$ 和 _ 组成，且必须以字母、$ 或 _ 开头（不能以数字开头）
- 禁止使用 Java 关键字，如 int、class、return 等
- 大小写敏感：userCount 和 UserCount 是两个不同变量，别混用
- 避免用 $ 和 _ 开头——它们虽合法，但易与编译器生成名（如内部类）冲突，日常开发中应主动避开
统一采用小驼峰命名法
这是 Java 社区最广泛接受、IDE 默认支持、新人最容易上手的风格。
- 首单词全小写，后续单词首字母大写：如 userName、maxRetryCount、isEmailVerified
- 布尔变量建议以 is、has、can、should 开头，直接体现真假语义
- 避免下划线分隔（如 user_name），除非是常量；也避免全大写缩写（如 XMLHandler 中的 XML 可接受，但 usrNm 不可取）
名字要能“自解释”，不依赖注释
好变量名 = 无需额外说明就能猜出用途。
立即学习“Java免费学习笔记（深入）”；
- 拒绝模糊简写：tmp、data、obj、val 等应视为警告信号
- 优先用完整英文词组合：customerOrderHistory 比 coHis 或 custOrdHist 更可靠
- 局部循环变量可用 i、j，但作用域一旦超出单层 for，就该换成 index、rowIndex 等明确名称
- 方法参数名尽量与对应字段名一致，例如 setPassword(String password)，保持上下文连贯
项目内保持风格闭环
一致性不是一个人的事，是整个代码库的呼吸节奏。
- 定义一份简明《命名速查表》，放在项目 README 或 Wiki 首页，包含：包名格式、类/接口/变量/常量/方法的命名示例
- 用 IDE 的 Inspection 或 Checkstyle 插件自动拦截违规命名（如检测到 USER_NAME 出现在非 static final 字段上）
- Code Review 时把变量命名列为必检项——哪怕逻辑正确，命名含糊也应要求修改
- 对已有不规范变量，不必一次性重构，但在每次修改其所在方法或类时，顺手更新为合规名称，积少成多
