Java Package 與 Import 完整指南：命名空間管理與類導入實戰

Java Package 與 Import 完整指南：命名空間管理與類導入實戰

package 與 import 是 Java 程式碼組織與模組化的基石。本文系統梳理其核心規則、使用場景、編譯運行機制及常見誤區，助力開發者建立清晰的專案結構認知。

Package 核心作用與規則

實戰代碼示範

定義包與類

package testPkg;

public class testPackage {
    public static void fun1() {
        System.out.println("Msg: testPackage print");
    }
    public static void main(String[] args) {
        fun1();
    }
}

跨包調用

import testPkg.testPackage;

public class testCallPackage {
    public static void main(String[] args) {
        testPackage.fun1();  // 等同於 testPkg.testPackage.fun1()
    }
}

編譯與運行關鍵步驟

1. 使用 -d 參數編譯：javac -d . testPackage.java，編譯器自動生成目錄結構 testPkg/testPackage.class
2. 類路徑設定：運行時需包含包根目錄，java testCallPackage（在包根目錄上層執行）
3. 目錄結構映射：包名層級對應目錄層級，com.company.project → com/company/project/

Import 進階用法

命名衝突解決策略

當兩個包含有同名類（如 java.util.Date 與 java.sql.Date）：

• 僅 import 其中一個，另一個使用完整限定名
• 或兩者都用完整限定名，不使用 import
• 禁用 同時 import 兩個同名類，會導致編譯錯誤

Java 源文件標準結構

package declaration        // 1. 包宣告（可選）
import statements          // 2. 導入語句（可選）
class/interface definition // 3. 類/介面定義（必須）

最佳實務建議

• 採用反向域名命名包：com.company.module
• 避免使用預設包，便於模組化與工具支援
• 優先單類 import，IDE 可自動優化組織
• 靜態導入僅用於極高頻使用的常數/方法（如測試斷言、數學常數）
• 包結構反映架構分層：controller、service、dao、entity

掌握 Package/Import 機制，不僅是語法要求，更是構建可維護、可擴展 Java 專案的架構基石。