Java命名规范是业界约定俗成的代码编写规则，违反这些规范会引发一系列代码审查问题，影响团队代码的整体质量和协作效率。
类名命名不规范问题
Java要求类名采用大驼峰命名法，即每个单词首字母大写，且类名要能清晰体现类的职责，常见的违反问题包括使用小写开头、包含下划线或者语义模糊。
审查时这类问题会被直接标记为不规范，因为不符合Java语言的通用约定，其他开发者阅读代码时需要额外花费时间理解类的用途。
// 不规范示例：类名小写开头，语义不清晰
class usercontroller {
// 类逻辑
}
// 不规范示例：类名包含下划线
class User_Info_Service {
// 类逻辑
}
// 规范示例
class UserController {
// 类逻辑
}
class UserInfoService {
// 类逻辑
}
方法名命名不规范问题
方法名需要采用小驼峰命名法，首字母小写，后续每个单词首字母大写，且方法名要准确描述方法的功能，常见的问题包括全大写、动词缺失、语义混乱。
这类问题会导致方法调用时无法快速判断方法的作用，增加代码维护的难度，尤其是当项目规模较大时，问题会更加明显。
// 不规范示例：方法名全大写
public void GET_USER_INFO() {
// 方法逻辑
}
// 不规范示例：方法名无动词，语义模糊
public void user() {
// 方法逻辑
}
// 规范示例
public void getUserInfo() {
// 方法逻辑
}
public void calculateTotalPrice() {
// 方法逻辑
}
变量名命名不规范问题
变量名同样采用小驼峰命名法，要求见名知意，不能使用无意义的单字母（除循环变量等特殊情况外），也不能使用拼音和英文混合的命名方式。
这类问题在代码审查中非常常见，无意义的变量名会让代码逻辑难以追踪，拼音混合命名则会给非中文母语的开发者造成阅读障碍。
// 不规范示例：无意义单字母变量
int a = 10;
String b = "test";
// 不规范示例：拼音英文混合
int yongHuNianLing = 20;
String dingDanBianHao = "123";
// 规范示例
int userAge = 20;
String orderNumber = "123";
// 循环变量特殊情况
for (int i = 0; i < 10; i++) {
// 循环逻辑
}
常量名命名不规范问题
常量名要求全部大写，单词之间用下划线分隔，且要清晰说明常量的含义，常见的问题包括小写、驼峰命名或者语义不明确。
常量通常是全局或者类内共享的固定值，不规范的命名会让开发者无法快速识别常量的用途，甚至误修改常量值引发线上问题。
// 不规范示例：常量用小驼峰命名 public static final int maxSize = 100; // 不规范示例：常量全小写 public static final int default_timeout = 5000; // 规范示例 public static final int MAX_SIZE = 100; public static final int DEFAULT_TIMEOUT = 5000;
包名命名不规范问题
包名要求全部小写，采用反域名命名规则，层级之间用点分隔，不能使用大写字母或者下划线，常见的问题是包名包含大写字母或者语义混乱。
包名不规范会导致项目结构不清晰，增加代码包路径的识别难度，也不符合Java的包管理约定。
// 不规范示例：包名包含大写字母 package com.Example.User; // 不规范示例：包名用下划线分隔 package com_example_user; // 规范示例 package com.example.user; package com.example.user.service;
命名规范违反的共性影响
所有命名规范违反的问题，在代码审查中都会被要求修正，除了影响可读性之外，还会导致以下问题：
- 增加新成员熟悉项目代码的时间成本
- 提升代码合并时的冲突概率
- 增加后续功能迭代时的维护风险
- 不符合团队代码规范，影响整体代码风格统一
开发者在编写代码时可以对照Java官方命名规范检查，也可以在IDE中配置对应的命名检查规则，提前发现不规范问题，减少代码审查的往返修改次数。
Java_naming_conventioncode_reviewidentifier_namingvariable_naming修改时间：2026-06-14 17:00:35