深入解析 Java 套件機制與命名空間管理

Java 套件 的核心概念與作用

在 Java 中，套件 是組織類別與介面的基本單位，提供命名空間隔離、存取權限控管與程式碼模組化的功能。良好的套件設計能有效避免類別名稱衝突，並提升專案的可維護性與可擴充性。

套件宣告與目錄結構對應

每個 Java 原始檔最開頭可使用 package 關鍵字宣告所屬套件：

package com.example.project.module;

public class MyClass {
    // 類別內容
}

編譯後的 .class 檔案必須置於與套件名稱對應的目錄階層中（例如 com/example/project/module/MyClass.class），JVM 才能正確載入。

匯入機制：import 指令詳解

• 單一類別匯入：import com.example.utils.StringHelper;
• 整個套件匯入：import com.example.utils.*;（僅匯入該層級類別，不遞迴子套件）
• 靜態匯入：import static java.lang.Math.PI; 可直接使用常數或靜態方法無需類別名稱前綴。

存取修飾詞與套件可見性

常見套件命名慣例

• 網域名稱反轉：com.company.project
• 功能導向：controller, service, repository, dto, exception
• 避免使用 Java 核心套件前綴（java.*, javax.*）

模組化系統

Java 9 引入模組系統，透過 module-info.java 宣告模組相依性與導出套件，提供更強的封裝性：

module com.example.app {
    requires java.sql;
    exports com.example.app.api;
}