Java / 系统课时
标识符与命名规范
标识符与命名规范
标识符用于命名类、方法、变量和常量。本课区分“语法合法”与“工程规范”,帮助你写出能编译且易维护的名称。
学习目标
- 判断标识符是否合法。
- 掌握常见Java命名风格。
- 使用有业务含义的名称。
合法性规则
Java标识符可由Unicode字母、数字、下划线_和美元符$组成,但不能以数字开头,也不能使用关键字。Java区分大小写,因此score与Score是不同名称。true、false和null也不能作为标识符。
java
public class IdentifierRules {
public static void main(String[] args) {
int userAge = 20;
int _cacheSize = 10;
int 年龄 = 18;
// int 2ndUser = 2; // 不能以数字开头
// int class = 1; // class 是关键字
// int user-name = 3; // 连字符不合法
System.out.println(userAge + _cacheSize + 年龄);
}
}预期输出:
text
48从 Java 9 起,单独的下划线是保留关键字,不能用作变量名。像 _cacheSize 这样更长的名字仍符合语法。团队项目通常使用能表达业务含义的英文名称。Java 语言规范的标识符规则
命名规范
| 程序元素 | 推荐形式 | 示例 |
|---|---|---|
| 类、接口 | 大驼峰 | StudentService |
| 方法、变量 | 小驼峰 | calculateTotal |
| 常量 | 全大写加下划线 | MAX_RETRY_COUNT |
| 包 | 全小写分段 | com.example.order |
规范不由编译器强制,但能让读者快速判断名称职责。优先使用remainingStock这类有业务含义的名称,避免rs等难懂缩写。
主示例
java
public class StudentScoreReport {
private static final int PASS_SCORE = 60;
public static void main(String[] args) {
String studentName = "李明";
int javaScore = 92;
boolean passed = javaScore >= PASS_SCORE;
System.out.println(studentName + " 是否通过:" + passed);
}
}预期输出:
text
李明 是否通过:true把含义和单位写进名称
在 StudentScoreReport.java 的类体中加入下面的方法,并在 main 中调用 System.out.println(remainingSeconds(90, 35));。输出应为 55。
java
static int remainingSeconds(int limitSeconds, int elapsedSeconds) {
return Math.max(0, limitSeconds - elapsedSeconds);
}用 remainingSeconds(90, 120) 再验证一次,预期为 0。名称里明确写出 Seconds,调用者就可以从接口判断两个参数都按秒传入。如果调用方拿到的是毫秒,应在调用前换算。下限取 0 的规则则可以直接从方法体和第二组结果读出来。
练习时先把参数改成 limit 和 elapsed,观察调用结果依然相同。再把 elapsedSeconds 改成 ElapsedSeconds 且只改声明,重新编译,检查报错中的符号名称。前一个改动改变阅读体验,后一个触发了大小写敏感的名称查找。
按自己的节奏,确认真正理解。