Java包机制通过命名空间、目录结构和访问控制三层面协同管理类，核心是以“包名+类名”构成全限定名实现隔离；不同包下可共存同名类（如com.example.user.User与com.example.order.User），JVM仅识别全限定名；package声明须首行且路径严格匹配；import仅为语法糖，同名类需用全限定名区分。
Java 通过包机制从命名空间、目录结构和访问控制三个层面协同管理类，从根本上避免命名冲突。核心不是“不让重名”，而是让重名的类拥有不同的全限定名（包名 + 类名），JVM 只认这个唯一标识。
包名即命名空间，天然隔离同名类
不同包下允许存在完全相同的类名，比如 com.example.user.User 和 com.example.order.User，它们在 JVM 中是两个完全独立的类型。就像“北京市朝阳区的王磊”和“杭州市西湖区的王磊”，地址不同，就不会混淆。
- 同一个包内不能有两个同名类，否则编译直接报错
- 跨包同名类可共存、可同时使用，只要引用时能区分全限定名
- JVM 在加载和运行时只依赖全限定名，不看简单类名
目录结构必须严格匹配包声明
包不是文件夹的别名，而是强制约定的路径映射。声明 package com.example.api;，源文件就必须放在项目根目录下的 com/example/api/ 子目录中。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- package 语句必须位于 .java 文件第一行非注释位置
- 编译器、类加载器都按此路径查找源码和 .class 文件
- 手动移动文件后忘记更新 package 声明，会触发 “class file contains wrong class” 错误
import 是语法糖，不是解决方案
import 只为简化书写，不参与类加载或冲突判定。当需要在同一个类里用到多个同名类（如 java.util.Date 和 java.sql.Date），靠 import 无法“同时导入”。
立即学习“Java免费学习笔记（深入）”；
- 只 import 其中一个，另一个用全限定名调用：new java.sql.Date(0)
- 两个都高频使用，建议全部写全限定名，逻辑更清晰、不易出错
- 绝对不要写两个 import 同名类，编译器会报 “The type X is ambiguous”
包名设计要规范且可扩展
包名承担着防止全局冲突和表达业务归属的双重作用，不能随意起名。
- 推荐反向域名风格：com.company.project.module（如 com.baidu.search.parser）
- 禁用单层包名（如 util、common），极易与第三方库冲突
- 只能用小写字母、数字、点号（.）、下划线（_），不能以数字或关键字开头
