Java 的 package 是编译器与 JVM 共同遵守的命名与路径绑定规则，强制要求源码路径、包名层级和类全限定名三者严格一致，缺一不可。
Java 中的 package 不是“文件夹别名”，而是编译器和 JVM 共同遵守的一套命名与路径绑定规则——它强制要求「源码路径 = 包名层级 = 运行时类全名」，三者缺一不可。
为什么必须写 package 且只能在第一行？
因为 package 声明直接参与类的**全限定名（Fully Qualified Name）** 构造。JVM 加载类时，只认 com.example.util.DateUtils 这种带包名的完整标识，不认裸名 DateUtils。
- 如果漏写
package，类就落入「默认包」，而默认包中的类无法被任何其他包 import（JDK 9+ 甚至禁止跨模块引用默认包） -
package必须在 import 和 class 之前，否则编译报错：error: class, interface, or enum expected - 注释可以放在
package前，但空行、import、类定义都不行
package 名和文件系统路径怎么严格对应？
不是“建议匹配”，而是**编译器硬性校验**：源文件必须放在与包名完全一致的子目录中，否则 javac 编译失败或运行时报 NoClassDefFoundError。
- 包名
com.example.web.controller→ 源文件路径必须是com/example/web/controller/MyController.java - 用
javac -d . MyController.java编译时，-d参数指定输出根目录，编译器会自动按包名创建子目录并放.class - 运行时命令必须用全限定名：
java com.example.web.controller.MyController，不能写java MyController
导入类时，import 和全限定名有什么实际区别？
import 只是语法糖，不改变字节码；但滥用通配符或错误导入会掩盖冲突、拖慢编译，并在重构时埋雷。
立即学习“Java免费学习笔记（深入）”；
-
import java.util.Date;和import java.sql.Date;同时存在 → 编译报错，必须用其中一个的全限定名（如java.sql.Date）显式声明 -
import com.example.*;不会导入子包（如com.example.util.*），也不推荐——IDE 难以精准提示，且可能意外引入不兼容版本 - 同一包内的类互相调用可省略包名，但跨包必须 import 或写全限定名；没 import 又没写全名 → 编译错误：
cannot find symbol
常见坑：包名大小写、特殊字符和 JDK 内置包的“隐身”规则
包名不是字符串，是 Java 标识符，受语法约束；而部分包（如 java.lang）被 JVM 特殊处理，导致新手误以为“不用 import 就能用所有基础类”。
- 包名必须全小写：
com.MyApp是非法的，编译通过但运行时类加载器找不到路径com/MyApp/（文件系统区分大小写） - 不能用数字开头、不能含
-或_，例如com.my-app.utils会报error: illegal character -
String能直接用，是因为java.lang被自动 import；但java.util.Objects就必须显式 import，否则编译失败 - 自定义包名别碰
java.xxx或javax.xxx—— 这些是 JDK 保留命名空间，类加载器会优先从 rt.jar 加载，你的类永远进不去
最常被忽略的一点：包结构一旦发布（尤其打成 jar），就几乎无法安全重命名——所有依赖它的代码、配置、反射调用都会断。所以从第一天起，就该按 域名倒序.项目.模块 定死，别图省事写 util 或 test。
