java变量命名必须统一用小驼峰（lowercamelcase），普通变量和方法名首词小写、后续单词首字母大写；布尔变量优先加is/has/can前缀；常量需满足public static final且类型安全才用全大写下划线；类名大驼峰、包名全小写、项目名全小写中划线；语义清晰优先，禁用模糊缩写与非ascii字符。

Java 变量命名必须统一用小驼峰（lowerCamelCase），这不是风格偏好，而是工程落地的硬性要求。它直接关系到代码是否被 IDE 正确识别、静态检查能否通过、团队协作是否顺畅。

变量和方法名：一律小驼峰，首词小写、后续单词首字母大写

所有普通变量（局部变量、参数、实例变量、非 final 静态变量）和方法名都必须遵守这一规则：

• ✅ 正确写法：userName、httpResponseCode、isValid、parseJson、calculateTotal
• ❌ 常见错误：user_name（下划线是 Python/Go 风格）、UserName（混淆类名）、username（多词时语义断裂）、ParseJson（方法名首字母大写像类）
• 布尔变量优先加 is/has/can 前缀，比如 isLocked、hasPermission、canRetry，比单纯用 locked 或 flag 更明确

常量名：仅限 public static final + 基本类型/不可变对象，才用全大写下划线

不是所有带 final 的变量都是常量，只有满足“public static final”且类型安全（如 int、String、Boolean）才算：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• ✅ 合规常量：public static final int MAX_RETRY = 3;、private static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
• ⚠️ 注意边界：final String apiKey; 是实例常量，仍用小驼峰；public static Map cache; 虽有 static，但非 final 且可变，不能用全大写
• 数字或单位缩写保持可读，比如 DEFAULT_TIMEOUT_MS、API_VERSION_2_1，避免 DEFAULTTIMEOUTMS 或 API_VER_21

类名、接口名、包名、项目名：各守各的规则，不混用

命名体系要整体协调，让名字自己表达用途：

• 类/接口：必须大驼峰（UpperCamelCase），如 UserService、XmlParser、HttpRequestHandler；缩写词首字母大写、其余小写（HttpServer ✅，HTTPServer ❌）
• 包名：全小写 + 点分隔，按反向域名组织，如 com.example.order、org.springframework.web
• 项目名：全小写 + 中划线，适配 CI/CD 和文件系统，如 user-service、payment-gateway；禁用下划线或大小混写（user_service、UserService ❌）

语义清晰优先，拒绝模糊缩写和无意义命名

好名字能减少 80% 的注释需求，关键在“说人话”：

• 用完整名词短语代替缩写：customerOrderList ✅，col 或 cList ❌
• 循环变量在业务逻辑中也要具名：for (Order order : orderList) ✅，for (Order o : list) ❌
• 与外部系统（JSON、数据库）字段不一致时，用注解映射，不妥协代码内命名：@JsonProperty("user_name") private String userName;
• 禁用中文、特殊 Unicode 字符、$ 或 _ 开头（如 _id）、数字开头（如 2ndAttempt）

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南