Java中package必须与文件系统目录结构严格一致，包名中的点号对应目录分隔符，源文件须位于源码根目录下与包名匹配的嵌套路径中，编译和运行时均需保持该结构。
Java 中的 package 与文件系统中的文件夹结构必须严格一致，这是编译器和类加载器运行的基本前提。
包名必须逐级匹配目录路径
例如声明 package com.example.utils;，则源文件必须位于 com/example/utils/ 目录下（注意是斜杠，与操作系统无关）。编译器不会自动创建或映射路径，它只按字面解析包名，并将点号（.）直接转为目录分隔符。
- Windows 下写成 com\example\utils 也能编译通过（因为 Java 内部统一处理为正斜杠），但推荐始终用正斜杠风格保持可移植性
- 若把 StringUtils.java 放在 src/utils/ 而声明 package utils;，那没问题；但若声明 package com.example.utils; 却放在 src/utils/，编译会失败：找不到预期的嵌套目录
源码根目录（source root）决定起始点
所谓“对应”，是从源码根目录开始计算。IDE 或构建工具（如 Maven）会明确指定哪个目录是源根（如 src/main/java）。所有 package 声明都相对于该根目录展开。
- Maven 项目中，src/main/java/com/example/App.java 必须声明 package com.example;
- 如果误把文件放在 src/main/java/com/example/，却声明 package example;，编译器会在 src/main/java/example/ 下找它，自然报错“类不在声明的包中”
类路径（classpath）影响运行时加载
编译通过只是第一步。运行时，JVM 通过 classpath 查找已编译的 .class 文件，仍需满足相同结构：类文件必须位于与包名对应的子目录中。
- javac -d out src/com/example/Utils.java 会把 Utils.class 输出到 out/com/example/Utils.class
- 运行时执行 java -cp out com.example.Utils，JVM 就会去 out/com/example/ 找 Utils.class
- 如果 class 文件被平铺放到 out/ 根下，即使编译成功，运行也会抛出 ClassNotFoundException
常见误区与验证方法
不依赖 IDE 自动补全，手动验证最可靠：
- 打开终端，进入源码根目录，用 find . -name "*.java" | grep -E "package.*;" 检查每个文件的 package 声明是否与其相对路径一致
- 编译后检查 .class 输出目录结构是否与包名完全嵌套，不要跳级或错位
- IDE 报 “Package does not exist” 或 “Cannot resolve symbol” 时，优先检查物理路径而非导入语句
