Linux 環境下 Java 套件（Package）入門：從 import 到 CLASSPATH 完整設定指南

套件基本觀念

Java 套件對應目錄階層，句點 . 代表路徑分隔符 /。例如 import doll.*; 會尋找 ./doll/ 目錄下所有 public 類別。

Ubuntu/OpenJDK 環境的 CLASSPATH 陷阱

若透過 sudo apt-get install openjdk-11-jdk 安裝，系統 不會自動設定 CLASSPATH，導致 import 當前目錄下類別失敗。需手動編輯 ~/.bashrc：

環境變數設定範例（假設 JDK 安裝於 /usr/lib/jvm/java-11-openjdk）

# ~/.bashrc 末尾新增
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/jre/lib
export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH:$HOME/bin

關鍵點：CLASSPATH 必須包含 .（當前目錄），否則 import doll.*; 找不到本地套件。

修改後執行 source ~/.bashrc 或重新開啟終端機生效。

完整實戰範例

1. 定義套件與類別

// 檔案：doll/Doll.java
package doll;

public class Doll {
    private String name;

    public Doll(String name) {
        this.name = name;
    }

    public void speak() {
        System.out.println(name);
    }
}

2. 主程式引用套件

// 檔案：App.java（置於 doll/ 目錄上層）
import doll.*;

public class App {
    public static void main(String[] args) {
        Doll doll = new Doll("Hello Doll");
        doll.speak();  // 輸出：Hello Doll
    }
}

3. 編譯與執行

# 目錄結構
.
├── App.java
└── doll
    └── Doll.java

# 編譯（自動建立 doll/Doll.class）
javac App.java

# 執行
java App

常見錯誤與排查

進階：模組化專案建議

實務專案建議使用 Maven/Gradle 管理模組與依賴，避免手動維護 CLASSPATH。典型結構：

my-project/
├── pom.xml
├── core-module/
│   └── src/main/java/com/example/core/...
└── app-module/
    └── src/main/java/com/example/app/App.java

Maven 自動處理編譯路徑、模組間依賴、測試編譯等，完全取代手動 javac/java 操作。