package 不是一个可以像 javac 或 java 那样在命令行中直接执行的命令。

package 是一个 Java 关键字，用在 Java 源代码文件（.java 文件）的开头，用来声明该文件中的类、接口等类型属于哪个包。

你的问题可以理解为两个层面：

1. 如何在代码中使用 package 关键字？
2. 如何在命令行中处理与 package 相关的编译和运行操作？

下面我将从这两个方面详细解释。

package 关键字的用法

package 用于组织和管理类，防止命名冲突，并控制访问权限，它必须作为源文件的第一条非注释、非空白的语句。

语法

package [package_name].[sub_package_name];

• package_name 是顶层包名，通常是小写字母。
• 用于分隔包的层级，形成包的层次结构。
• com.example.utils 或 org.apache.commons.lang3。

示例

假设我们正在创建一个简单的工具类 StringUtils.java，我们希望将它放在 com.mycompany.utils 这个包下。

文件路径： src/com/mycompany/utils/StringUtils.java

// 第一行必须是 package 声明
package com.mycompany.utils;
/**
 * 一个简单的字符串工具类
 */
public class StringUtils {
    /**
     * 检查字符串是否为 null 或空
     * @param str 要检查的字符串
     * @return 如果为 null 或空则返回 true
     */
    public static boolean isEmpty(String str) {
        return str == null || str.trim().isEmpty();
    }
}

要点：

• package 声明定义了类的“完全限定名”（Fully Qualified Name），即 com.mycompany.utils.StringUtils。
• 文件系统中的目录结构必须与包的结构严格对应,即 com.mycompany.utils 包下的类，必须存放在 .../com/mycompany/utils/ 目录下。

命令行中处理 package 的操作

当你的代码使用了 package 关键字后，你在使用 javac（编译）和 java（运行）命令时就需要特别注意路径问题。

场景设定

假设我们有以下项目结构：

my-project/
└── src/
    └── com/
        └── mycompany/
            └── app/
                ├── Main.java      (主程序)
                └── model/
                    └── User.java  (模型类)

User.java 的内容：

package com.mycompany.model;
public class User {
    private String name;
    private int age;
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }
    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + "}";
    }
}

Main.java 的内容：

package com.mycompany.app;
import com.mycompany.model.User; // 引用另一个包中的类
public class Main {
    public static void main(String[] args) {
        User user = new User("Alice", 30);
        System.out.println("Hello, " + user);
    }
}

编译

目标：将 .java 文件编译成 .class 文件。

错误的命令：

# 错误：在 src 目录下执行
cd src
javac com/mycompany/app/Main.java

这会报错,因为 javac 在编译 Main.java 时，需要导入 com.mycompany.model.User，但它不知道去哪里找这个类，默认情况下，javac 只会在当前目录下查找。

正确的命令：

你需要告诉 javac 从哪个根目录开始查找源文件，这个根目录就是 src。

# 1. 进入项目根目录
cd my-project
# 2. 使用 -d 指定编译后的 .class 文件的输出目录，并指定源文件根目录
javac -d bin src/com/mycompany/app/Main.java src/com/mycompany/model/User.java

命令解析：

• javac: 编译器命令。
• -d bin: 指定一个输出目录（我们创建一个 bin 目录），编译器会根据包结构自动在 bin 目录下创建相应的子目录（bin/com/mycompany/app/），并将 .class 文件放入其中。
• src/com/mycompany/app/Main.java src/com/mycompany/model/User.java: 要编译的源文件列表，必须包含所有被依赖的类。

编译后的目录结构：

my-project/
├── bin/
│   └── com/
│       └── mycompany/
│           ├── app/
│           │   └── Main.class
│           └── model/
│               └── User.class
└── src/
    └── com/
        └── mycompany/
            ├── app/
            │   └── Main.java
            └── model/
                └── User.java

更方便的编译方式： 如果项目文件很多，手动列出所有文件很麻烦，可以使用通配符 。

# 在 my-project 目录下执行
javac -d bin src/com/mycompany/**/*.java

• src/com/mycompany/**/*.java 会递归匹配 src/com/mycompany 目录及其所有子目录下的所有 .java 文件。

运行

目标：执行编译后的 Main.class 文件。

错误的命令：

# 错误1：直接在 bin 目录下运行
cd bin
java com.mycompany.app.Main
# 会报错：找不到主类

因为 java 命令默认从当前目录（bin）加载类，但它需要的是类的包路径，而不是文件系统路径。

错误的命令：

# 错误2：在项目根目录下运行
cd my-project
java com.mycompany.app.Main
# 同样会报错：找不到主类

因为 java 命令不知道去 bin 目录里找 .class 文件。

正确的命令：

你需要告诉 java 虚拟机去哪里寻找 .class 文件，这个位置是包含 com 这个顶级包的目录，也就是我们的 bin 目录。

# 1. 确保你在项目根目录 (my-project)
cd my-project
# 2. 使用 -cp (classpath) 指定类路径
java -cp bin com.mycompany.app.Main

命令解析：

• java: 虚拟机命令。
• -cp bin (或 -classpath bin): 这是最关键的一步，它告诉 JVM，在运行时去 bin 这个目录下查找类文件，JVM 会在 bin 目录下根据包名 com.mycompany.app.Main 去寻找对应的 Main.class 文件。
• com.mycompany.app.Main: 这是类的完全限定名，而不是文件路径，JVM 会根据这个名字和 -cp 指定的路径来定位文件。

执行结果：

Hello, User{name='Alice', age=30}

总结与最佳实践

最佳实践：构建工具 (Maven/Gradle)

手动处理 javac 和 java 命令对于大型项目来说非常繁琐且容易出错，业界标准的做法是使用构建工具，如 Maven 或 Gradle。

• Maven/Gradle 会自动处理所有路径问题，你只需要在 pom.xml (Maven) 或 build.gradle (Gradle) 文件中定义好项目结构（源码在 src/main/java，编译后输出到 target/classes）。
• 你只需要运行一个简单的命令,mvn compile 或 gradle build，工具就会自动完成编译、打包、测试等一系列复杂操作。
• 运行时,也只需使用 mvn exec:java -Dexec.mainClass="com.mycompany.app.Main" 这样的命令，工具会自动配置好正确的 classpath。

对于初学者,理解手动编译和运行的流程非常重要；对于实际开发，强烈建议尽早学习和使用 Maven 或 Gradle。