Java 变量命名规范与小驼峰写法详解

Java变量的命名必须是小驼峰(如username)、语义清晰禁用关键词和数字开头常用全部写下划线(如MAX__CONNECTIONS添加is//布尔变量has/can前缀。Java 变量命名必须遵循语义清晰、可读性强、符合语言约定的原则包括小驼峰lower camelCase是行业内官方推荐和通用的写作方法。变量命名的基本规则Java 变量名必须满足以下硬性要求只能从字母、下划线(_)或美元符号($)开始不能从数字开始后续字符可以包括字母、数字、下划线或美元符号严格区分大小写count 和 Count 是两种不同的变量不能使用 Java 关键字如 int、class、return 等)作为变量名避免使用中文或特殊语言 Unicode 字符(即使语法允许也会严重降低可维护性)小驼峰lower camelCase的正确写法小驼峰是指第一个单词全小写每个单词的第一个字母大写其余的字母小写单词之间没有空间或分隔符。✅ 正确示例userName不是username或User_NamemaxRetryCount不是MaxRetryCount或max_retry_countisAvailable(常用的布尔变量is/has/can开头xmlParser缩写词如 XML、HTTP 一般都是大写但作为中间部分只有首字母大写)❌ 常见错误首字母大写UserName → 这是大驼峰用于类名)下划线分隔user_name → Python/Go 风格Java 中不推荐全大写USERNAME → 适用于常量禁用非常量变量)缩写混乱usrNm 或 uName → 损害可读性应写全部)语义优先:名字要“说人话”命名不是拼凑单词而是表达意图。一个好的变量名可以减少注释的需要。用 descriptive(描述)名称代替缩写或单字母: ✅ customerOrderList❌ col 或 cList推荐带语义前缀的布尔变量 ✅ isValid、hasPermission、canEdit❌ valid、flag1在简单的场景下循环变量可以使用短名(例如 i、j但是在涉及业务逻辑时应具名 ✅ for (Order order : orderList)❌ for (Order o : list)处理特殊情况的建议在实际开发中会遇到边界情况需要灵活但不失规范常量static final全部大写 下划线分隔如 MAX_CONNECTIONS、DEFAULT_TIMEOUT_MS私有字段仍然使用小驼峰不需要添加标记前缀如 private String firstName;不是 private String _firstName;与 JSON/数据库字段映射:通过注释保持代码中的小驼峰(如 JsonProperty(user_name) 或 Column(name user_name()做转换不妥协命名规范避免数字结尾的歧义例如 value1、value2 语义化不够优先使用 initialValue、updatedValue 等待名称的明确含义