Java import 機制：import com.hello.person 到底是匯入類別還是套件？

Java import 語句中，import com.hello.person 究竟代表匯入 person.java 類別，還是 person 套件（資料夾）？判斷依據是什麼？本文給出明確規則。

核心規則

判斷依據

1. 是否有結尾 .*：有 → 套件匯入；無 → 單一類別匯入。
2. 編譯時期檢查：import com.hello.person; 若 person 是目錄而非類別，編譯器報錯 cannot find symbol。
3. 原始碼結構：類別檔 Person.java (慣例首字大寫)；套件目錄 person/ (慣例全小寫)。

常見誤區

「import 會匯入 .java 檔案」——錯誤。import 僅告訴編譯器類別的完整限定名，編譯器載入的是 .class 檔案（或模組中的類別資料）。

最佳實務

• 類別名採 PascalCase（Person、UserService），套件名全小寫（com.hello.person、com.hello.service），從命名即可區分。
• 避免「類別名與套件名同名」造成混淆（如 com.hello.person.Person 較佳）。
• 使用 IDE 自動匯入 (Ctrl+Shift+O)，減少手寫錯誤。

補充：靜態匯入

import static com.hello.person.Person.MAX_AGE;  // 匯入靜態欄位/方法
import static com.hello.person.Person.*;        // 匯入所有靜態成員

牢記「無星號=類別、有星號=套件」，即不會再混淆 import 目標。