Java / 系统课时
包机制与代码组织
包机制与代码组织
包既是 Java 类型的命名空间,也是组织源代码的重要边界。本课通过一个拆分为 model 与 app 的最小项目,说明包声明、目录结构、导入、编译输出和运行类名如何对应。
学习目标
- 理解包名与类型全限定名
- 建立包声明和目录结构的映射
- 从命令行编译并运行多包程序
包名、目录与类路径
com.anystack.model.User 由包名和类名共同组成,因此不同包可以存在同名类。普通 Java 源文件若有 package 声明,它出现在导入和类型声明之前,可以由注释或注解引领。建议让源目录与包名层级一致,方便工具按包名寻找源文件。
import 只简化源代码中的类型书写,不会复制类,也不会建立继承关系。编译时可用 -d 指定类文件输出根目录,运行时则通过类路径和全限定类名定位入口类。

主示例
先创建目录:
src/
└── com/
└── anystack/
├── app/
│ └── Main.java
└── model/
└── User.javasrc/com/anystack/model/User.java:
package com.anystack.model;
public class User {
private final String name;
public User(String name) {
// public 构造方法允许其他包创建 User
this.name = name;
}
public String greeting() {
return "你好," + name;
}
}src/com/anystack/app/Main.java:
package com.anystack.app;
import com.anystack.model.User;
public class Main {
public static void main(String[] args) {
// import 后可使用简单类名 User
User user = new User("Anystack");
System.out.println(user.greeting());
}
}编译并运行:
javac -d out src/com/anystack/model/User.java src/com/anystack/app/Main.java
java -cp out com.anystack.app.Main预期输出:
你好,Anystack关键边界
目录与 package 不一致时,IDE、编译器或构建工具可能无法正确定位类型。运行有包声明的主类时必须使用全限定类名,而不是只写 Main。
两个包中存在同名类时,不能同时通过简单名称导入;通常导入一个,另一个使用全限定名。包名一般使用反向域名并全部小写。
从类路径推算虚拟机查找的位置
运行 javac -d out ... 后,在项目根目录检查 out/com/anystack/app/Main.class 是否存在。-cp out 给出查找的起点,随后 Java 根据 com.anystack.app.Main 推导包目录和文件名。运行入口写类名,路径由类加载过程推导。
java -cp out com.anystack.app.Main
java -cp out/com/anystack/app com.anystack.app.Main
java -cp out Main第一条应输出 你好,Anystack。第二条的起点已经进入包目录,按包名继续查找就会找不到主类。第三条只会在类路径根目录查找无包的 Main。如果第一条也失败,先确认终端位于项目根目录,再核对编译产物。如果提示 User 无法访问,检查类型及构造方法是否需要对其他包声明为 public。