Java类名必须使用大驼峰命名法,如UserService、XmlParser;禁止下划线、小驼峰、数字开头或全大写缩写;需准确表达职责,避免模糊词;接口与实现类命名应逻辑一致。

Java 类名必须使用大驼峰(UpperCamelCase),即每个单词首字母大写,其余小写,不包含下划线或数字开头,且应准确表达类的职责。
类名必须是大驼峰格式
这是 Java 官方《Code Conventions for the Java Programming Language》明确要求的。类名作为类型标识,需具备可读性与一致性。
- ✅ 正确示例:UserService、HttpClientFactory、XmlParser
- ❌ 错误示例:user_service(下划线)、userService(小驼峰,适用于变量)、123Service(数字开头)、XMLParser(全大写缩写不规范)
缩写词处理要统一且可读
常见缩写如 XML、HTTP、URL、ID、DAO 等,在类名中建议首字母大写、其余小写,保持整体驼峰结构清晰。
- ✅ 推荐:XmlReader、HttpServer、UserIdGenerator、OrderDao
- ⚠️ 注意:XMLReader 或 xmlReader 易引发歧义或违反规范,应避免
名称要体现抽象层级与业务含义
类名不是拼凑单词,而是传达“它是什么”——是实体、服务、工具、异常还是策略?避免模糊词如 Manager、Handler、Util 单独使用。
立即学习“Java免费学习笔记(深入)”;
- ✅ 清晰表达:PaymentProcessor、InventoryValidator、CsvExportService
- ❌ 模糊低信息量:PaymentHandler(没说明做什么)、Utils(无上下文)、DataHelper(职责不清)
接口与实现类命名保持逻辑一致
接口强调“能力”,实现类强调“方式”。推荐接口用名词或形容词+名词,实现类在接口名前/后加具体技术或场景修饰。
- ✅ 常见模式:Repository → JdbcUserRepository、RedisCacheService → CaffeineCacheService
- ✅ 可接受但非强制:UserRepository(接口) + UserRepositoryImpl(实现),仅在简单项目中适用










