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 且只改声明,重新编译,检查报错中的符号名称。前一个改动改变阅读体验,后一个触发了大小写敏感的名称查找。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

标识符与命名规范

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通