Java中package声明必须是文件第一行非注释代码，因为编译器需在解析阶段确定类的完整限定名，否则报错“class, interface, or enum expected”；其前仅允许空白符和注释，不可有import或任何代码。
Java中package声明为什么必须是文件第一行非注释代码
因为JVM加载类时，会严格按package语句定位类的完整名称（Fully Qualified Name），如果它不在顶部，编译器无法在解析阶段确定该类属于哪个命名空间，直接报错class, interface, or enum expected。
-
package语句前只能有空白符和单行/多行注释，不能有import、变量声明或任何可执行代码 - 哪怕只写了一行
System.out.println("hello");在package之前，也会导致编译失败 - IDE有时会自动补全
package，但如果你复制粘贴了带前置日志的代码片段，很容易踩这个坑
同名类冲突：不写package和写错package的实际影响
没声明package的类默认属于“无名包”（unnamed package），而所有显式声明package com.example.util;的类都属于命名包。这两者互不可见——即使类名相同，JVM也认为它们毫无关系；但一旦两个类都声明了相同的package，又放在不同目录下被同时引入，就会触发duplicate class编译错误。
- 常见误操作：把
A.java从src/main/java/com/example复制到src/test/java/com/example但忘了改package，结果测试编译时报class A is already defined in this compilation unit - Maven项目里，
src/main/java和src/test/java是隔离的源码路径，但只要package一致、类名一致，且被同一编译单元看到，就冲突 - 运行时若通过反射加载，还可能因类加载器委托机制导致意外覆盖——比如自定义
ClassLoader加载了同名但不同路径的类
package路径与文件系统路径必须严格匹配
Java要求package com.example.dao;对应的文件，必须放在com/example/dao/子目录下。这是硬性约定，不是IDE或构建工具的建议；javac在编译时会据此查找源文件，否则报error: class X is public, should be declared in a file named X.java，甚至找不到类。
- Windows上大小写不敏感，可能掩盖问题；Linux/macOS上
com/example/DAO和com/example/dao会被视为不同路径，导致ClassNotFoundException - IDEA默认开启“use module compile output path”，但如果你手动调用
javac，必须确保-d指定的输出目录结构与package完全对应 - 不要依赖IDE自动创建包目录——有时它建的是
com.example.dao这种扁平目录名，而非嵌套文件夹，编译必然失败
import和package配合时容易忽略的可见性细节
import只是告诉编译器“我要用某个类的简写名”，真正决定能否访问的，是package层级 + 访问修饰符。比如protected成员只对同一package内的类可见，跟import无关；而default（包级私有）成员连子包都访问不了。
立即学习“Java免费学习笔记（深入）”；
- 写了
import com.example.util.Helper;不代表你能调用它的default方法，除非你也在com.example.util包里 - 子包如
com.example.util.sql不能直接访问父包com.example.util中的default字段，必须提升为protected或public - 模块化（Java 9+）下，
module-info.java里的exports才真正控制跨模块的package可见性，此时import和package只是基础前提
package机制本质不是“文件夹分类”，而是命名空间划分 + 访问控制锚点。很多人调通了路径就以为搞定，但一动访问权限或跨模块引用，问题才真正浮现。
