Java 命名规范详解 | Baeldung中文网

1. 概述

本文将深入探讨 Java 开发中核心命名规范，这些规范帮助我们编写清晰、可维护且风格一致的代码。遵循这些规范能显著减少歧义，提升团队协作效率。

我们将重点解析以下元素的命名最佳实践：

类
接口
方法
变量
包
枚举
注解

2. 类命名规范

类名必须使用大驼峰命名法（UpperCamelCase），名称应具备描述性，优先使用名词或名词短语来准确表达其建模的实体或职责：

class CustomerAccount {
}

在这个例子中，CustomerAccount 类名直接表明其职责是管理客户账户信息。✅ 避免使用缩写或模糊名称，确保代码自解释性。

3. 接口命名规范

接口命名同样采用大驼峰命名法，名称需清晰表达实现类应具备的行为或契约：

interface Printable {
}

此例中，Printable 接口明确定义了打印功能的契约。接口名应直指其核心目的，避免产生歧义。

4. 变量命名规范

变量命名需兼顾清晰性与一致性，重点关注：

可变字段：使用小驼峰命名法（lowerCamelCase）
常量：使用全大写下划线命名法（UPPER_SNAKE_CASE）

public class CustomerAccount {
    private String accountNumber;
    private double balance;

    public static final double MAX_BALANCE = 1000000.00;
}

示例中：

accountNumber 和 balance 是实例变量
MAX_BALANCE 是用 static final 修饰的常量

⚠️ 当变量表示多个元素时，强烈建议使用复数形式（如 items 而非 itemList），提升可读性。

5. 方法命名规范

方法名必须使用小驼峰命名法，且以动词开头，准确描述其执行的操作：

public void deposit(double amount) {
    if (balance + amount > MAX_BALANCE) {
        System.out.println("Deposit exceeds max balance limit.");
    } else {
        this.balance += amount;
    }
}

deposit() 方法名直观表明其功能：向账户余额增加金额。

接口方法同样遵循此原则：

public interface Printable {
    void print();
}

print() 方法名简洁表达了输出行为。

✅ 当方法返回多个元素时，使用复数形式命名（如 getUsers()）能更清晰表达结果特性。

6. 包命名规范

包名必须全小写字母，并采用反向域名表示法：

package com.baeldung.namingconventions;

这种命名方式：

逻辑组织代码结构
最大程度避免包名冲突
符合行业标准实践

7. 枚举命名规范

枚举类型使用大驼峰命名法，其常量使用全大写下划线命名法：

enum DayOfWeek {
    SUNDAY,
    MONDAY,
    TUESDAY,
    WEDNESDAY,
    THURSDAY,
    FRIDAY,
    SATURDAY
}

这种命名方式能快速区分：

DayOfWeek：枚举类型（可变）
SUNDAY 等常量：不可变值

8. 注解命名规范

注解类型命名采用大驼峰命名法，与类/接口保持一致：

@interface Auditable {
    String action();
}

@Auditable 注解名清晰表明其用于审计功能。应用时能为方法或类提供明确的元数据信息。

9. 总结

本文系统梳理了 Java 核心元素的命名规范：

类/接口/注解：大驼峰命名法
方法/变量：小驼峰命名法
常量/枚举值：全大写下划线命名法
包：全小写反向域名

遵循这些规范能带来三大核心价值：

✅ 提升代码可读性
✅ 增强团队协作效率
✅ 降低长期维护成本

记住：好的命名是自文档化代码的基础，比任何注释都更有说服力。

Persistence

REST

Security