Java Package 與 Import 機制深度解析：從編譯到執行期的類加載全流程

核心原則：目錄結構必須映射包結構

package a.b.c;
public class Hello { ... }

• 源檔必須位於 .../a/b/c/Hello.java
• 編譯產出 .../a/b/c/Hello.class
• 執行命令：java a.b.c.Hello (從 Classpath 根目錄下的 a/b/c/Hello.class 載入)

違反此原則 → NoClassDefFoundError: wrong name。

編譯期：類路徑引用表與 Make 機制

1. 建立 類路徑引用表：依據 -classpath / CLASSPATH 環境變數 (預設 . 當前目錄)，-classpath 覆蓋環境變數，無疊加
2. 掃描源檔 import 陳述式，解析包名
3. 在類路徑引用表各根目錄下尋找 包名/類名.java 或 .class
4. 找到源檔 → 遞歸編譯 (Make)；找到類檔 → 直接使用；找不到 → 編譯錯誤
5. 同目錄下無包類 (Default Package) 優先被採用 (危險！)

執行期：動態連結與類加載器

• 每個 .class 獨立載入，視為動態連結庫
• 類檔內部儲存 完全限定名 (如 a/b/c/Hello)，import 僅供編譯期解析，運行期不存在
• 啟動 java a.b.c.Hello → 建立類路徑引用表 → 合成絕對路徑 classpath根/a/b/c/Hello.class → 讀取位元組碼 → 驗證內部類名匹配 → 定義類 → 初始化
• 不匹配 → NoClassDefFoundError: wrong name

Classpath 陷阱與最佳實踐

進階：JAR 包與 Classpath

# 編譯
javac -classpath d:\a.zip MyClass.java
# 執行
java -classpath d:\a.zip;. MyClass

• JAR 視為目錄樹根，包結構對應 JAR 內部路徑
• . 代表當前目錄，必須顯式加入若需載入當前目錄類

模組化系統 (Java 9+)

• module-info.java 宣告 exports, requires
• --module-path 取代 -classpath
• 強封裝：未導出包不可訪問，編譯/運行期同樣強制
• javac --module-source-path src -d out --module my.app

總結

Java Package/Import 機制核心在於 源碼/位元組碼目錄結構與包名完全對應。編譯期靠 -classpath 尋找定義，運行期靠類加載器按完全限定名定位。嚴守目錄結構、拒絕 Default Package、顯式管理 Classpath、拥抱模組化，是避免類加載地獄的鐵律。