Java中package声明必须严格匹配目录结构，如package com.example.util;要求文件位于com/example/util/目录下，且public类名须与文件名一致；编译运行需按包路径操作，否则报错。
Java 中 package 声明必须与源文件在文件系统中的目录结构严格对应，这是编译器识别类归属和进行类加载的基础规则。
package 名称必须匹配目录层级
包名中的每一级（用点号分隔）都对应一个子目录。例如：
-
package com.example.util;要求该.java文件必须位于com/example/util/目录下 -
package org.apache.commons.lang3;对应路径为org/apache/commons/lang3/ - 顶层包（如
package utils;）对应项目源码根目录下的utils/子目录
源文件名必须与 public 类名一致
若类声明为 public，则其所在文件名必须完全相同（含大小写），且扩展名为 .java：
-
public class StringUtils { ... }→ 必须保存为StringUtils.java - 一个
.java文件中最多只能有一个public类，且文件名必须匹配它 - 非
public类可与文件名不同，但无法被其他包直接访问
编译和运行时依赖路径结构
javac 和 java 命令默认按包路径查找源文件和类文件：
- 编译：
javac com/example/util/StringUtils.java（从源码根目录执行） - 运行：
java com.example.util.StringUtils（类路径需包含源码根或输出目录） - IDE（如 IntelliJ、Eclipse）会自动维护该映射，但命令行操作必须手动确保目录正确
常见错误与检查建议
以下问题通常源于路径与 package 不一致：
-
error: class XXX is public, should be declared in a file named XXX.java—— 文件名不匹配 -
error: package com.example.util does not exist—— 编译时未在正确的目录层级下执行，或类路径未包含源码根 - 运行时报
NoClassDefFoundError—— 类路径中缺少对应包路径，或 .class 文件未生成在正确目录 - 建议：用
ls -R（Linux/macOS）或tree（Windows）检查实际目录结构是否与 package 声明逐级吻合
