java 包如何命名

Java 包命名规范

Java 包的命名需遵循官方规范和行业惯例，以确保代码的可读性和唯一性。以下是核心原则和实践方法：

使用小写字母

包名全部使用小写字母，避免大写或混合大小写。例如：

com.example.myproject

反向域名约定

以公司或组织的互联网域名反向排列作为前缀，确保全球唯一性。例如：

• 域名 example.com → 包前缀 com.example
• 域名 acme.org → 包前缀 org.acme

项目或模块名称

在反向域名后追加项目或模块名称，例如：

com.example.utilities
org.acme.inventory

避免Java保留字

禁止使用Java关键字（如 int、class）或顶级域名（如 com、org）单独作为包名。错误示例：

com.int.project  // 错误：int是关键字

多单词命名

如需多个单词，使用连缀的小写字母，不推荐下划线或驼峰式。例如：

com.example.dataanalysis  // 正确
com.example.dataAnalysis  // 不推荐

功能分层命名

按功能或层级进一步细分包结构，例如：

com.example.dao        // 数据访问层
com.example.service    // 业务逻辑层
com.example.model      // 数据模型层

特殊场景处理

• 未注册域名的项目：使用 io.github.username（GitHub项目）或非标准前缀如 internal.project。
• 测试代码：通常添加 .test 后缀，例如：

  com.example.core.test

示例完整结构

// 公司域名 + 项目 + 模块
com.example.portal.ui
com.example.portal.backend

// 开源项目（GitHub）
io.github.username.library

通过遵循这些规则，可确保包名既符合规范，又能避免命名冲突。