java包机制通过“包名+类名”构成全局唯一的全限定名（如com.example.admin.user与com.example.api.user），从根本上解决同名类冲突；package语句须位于源文件首行非注释位置，目录结构必须严格匹配包路径，包名推荐反向域名规范。
包机制是Java用来组织类、避免命名冲突的核心设计，不是可选项，而是工程规范的起点。它通过给类名加上层级前缀（如 com.example.user.User），让原本相同的简单类名（User）变成互不干扰的全限定名，从而从根源上消除JVM识别歧义。
包机制怎么解决同名类冲突
冲突本质不是“名字一样”，而是“全限定名重复”。两个 User 类如果分别属于 com.company.admin.User 和 com.company.api.User，它们在JVM眼里就是完全不同的类——就像“北京朝阳区的张三”和“上海浦东新区的张三”，地址不同，人就不重。
- package语句必须写在.java文件第一行非注释位置，且只能有一个
- 源码目录结构必须严格匹配包路径：比如 package com.example.service; 就要求文件放在 com/example/service/ 目录下
- 包名推荐用反向域名（如 cn.myorg.project），确保全局唯一性
- 包之间没有父子继承关系：com.a 和 com.a.b 是两个独立包，不是包含关系
import语句如何精准处理同名类引入
当两个不同包里都有 Date、Response 这类高频同名类时，import本身不会“抹平”冲突，但提供了明确、可控的消歧手段：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 只导入一个：用 import java.util.Date; 后，直接写 Date date = new Date();
- 同时用两个：不能只靠import，必须显式使用全限定名，例如：
java.util.Date utilDate = new java.util.Date();
java.sql.Date sqlDate = new java.sql.Date(0); - 避免 import xxx.* 用于含同名类的场景：通配符导入可能引发编译错误，尤其当两个 * 包都含 Logger 之类通用名时
- import static 不解决类名冲突，只简化静态成员调用，与本题无关
实际编码中该怎么做
真正“彻底抹平”的不是语法技巧，而是工程习惯：
- 绝不使用默认包（即不写package语句），这是所有规范的第一条铁律
- 团队统一包命名规则，比如后端服务统一用 cn.org.xxx.backend，前端DTO用 cn.org.xxx.dto
- IDE自动导入时，遇到同名提示，手动选择并确认包路径，不点“全部导入”
- 关键模块间通过接口+包隔离，比如让 admin.User 和 api.User 都实现同一个 UserContract 接口，业务层只依赖接口
不复杂但容易忽略：包机制不是为编译器服务的，是为人服务的——让每个类在哪、为什么在这、跟谁有关，一目了然。
