java 通过包(package)机制为类提供命名空间,从而有效避免不同模块或第三方库之间的命名冲突。具体做法是在源文件顶部使用 package 关键字声明所属包名,并确保文件路径与包名结构一致;编译时使用 -d 参数指定输出目录,运行时通过类全限定名(如 com.example.myclass)引用该类。

如何声明包并匹配文件系统结构
在 Java 中,每个类必须属于一个包,除非它被声明为默认包(不推荐)。声明包的关键是在源文件的非注释、非空行第一行写入 package com.myapp.utils;。此时,该源文件必须位于名为 com 的目录下,其子目录为 myapp,再下一级为 utils,且文件名需与公共类名一致。这种映射关系确保了编译器能根据类的全限定名定位到正确的物理文件。

package com.myapp.utils;
public class Calculator {
public static int add(int a, int b) {
return a + b;
}
}
上述代码定义了一个简单的计算器类。假设项目根目录为 /project/src,则此文件应保存为 /project/src/com/myapp/utils/Calculator.java。编译时,若进入 /project/src 目录执行 javac -d . com/myapp/utils/Calculator.java,编译器会在当前目录下创建 com/myapp/utils/ 目录结构,并将生成的 Calculator.class 放入其中。这种结构严格遵循包名层级,是避免命名冲突的基础。
如何在其他类中导入并使用带包的类
当另一个类需要调用 Calculator 时,必须通过 import 语句引入该包,或者使用全限定名直接访问。推荐使用 import 语句提高代码可读性。例如,在 /project/src/com/myapp/Main.java 中,可以写 import com.myapp.utils.Calculator;,然后在方法体内直接调用 Calculator.add(1, 2)。若不导入,则需写 com.myapp.utils.Calculator.add(1, 2)。这种机制允许不同包中存在同名类(如 java.util.List 和 java.sql.List),只要通过不同的包前缀区分即可,从而彻底解决命名冲突。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

package com.myapp;
import com.myapp.utils.Calculator;
public class Main {
public static void main(String[] args) {
int result = Calculator.add(5, 3);
System.out.println("Result: " + result);
}
}
该主程序展示了完整的调用流程。首先,Main 类位于 com.myapp 包下,它通过 import 引入了 com.myapp.utils.Calculator。在 main 方法中,直接调用静态方法 add 并打印结果。编译时需确保 Calculator.class 在类路径中。若存在另一个包 com.other.utils 中也定义了 Calculator 类,只需将 import 改为 import com.other.utils.Calculator; 或使用全限定名,即可明确指定使用哪个实现,避免了歧义。
当两个不同包中有同名类时如何处理
如果项目中同时引入了两个包含同名类的包,例如 com.libA.Date 和 com.libB.Date,直接使用 import 会导致编译错误,因为编译器无法确定引用的是哪一个。此时,必须放弃通配符或单类导入,改用全限定名来实例化或调用方法。例如,要使用 libA 的日期类,需写 com.libA.Date dateA = new com.libA.Date();;而使用 libB 的则写 com.libB.Date dateB = new com.libB.Date();。这种方式虽然代码稍长,但能精确控制类来源,确保逻辑正确。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










