您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Class.getResource 與 ClassLoader.getResource 路徑解析規則徹底講透

編輯：Java 綜合教學

核心結論速查表

方法	路徑以 `/` 開頭	路徑不以 `/` 開頭
`Class.getResource(path)`	從 ClassPath 根目錄查找	從當前類所在包目錄查找（相對路徑）
`ClassLoader.getResource(path)`	不允許以 `/` 開頭（返回 null）	從 ClassPath 根目錄查找（絕對路徑）

詳細規則與代碼驗證

1. Class.getResource(String path)

package testpackage;

public class TestMain {
    public static void main(String[] args) {
        // 當前類所在包目錄
        System.out.println(TestMain.class.getResource(""));
        // ClassPath 根目錄
        System.out.println(TestMain.class.getResource("/"));
    }
}

輸出（Eclipse 環境）：

file:/E:/workspace/Test/bin/testpackage/
file:/E:/workspace/Test/bin/

實戰示例

假設項目結構：

bin/
├── 1.properties              ← ClassPath 根
├── testpackage/
│   ├── TestMain.class
│   ├── 2.properties          ← 同包資源
│   └── subpackage/
│       └── 3.properties      ← 子包資源

// 同包資源：相對路徑
TestMain.class.getResource("2.properties")
// → file:/E:/workspace/Test/bin/testpackage/2.properties

// 子包資源：相對路徑 + 子目錄
TestMain.class.getResource("subpackage/3.properties")
// → file:/E:/workspace/Test/bin/testpackage/subpackage/3.properties

// 根目錄資源：絕對路徑
TestMain.class.getResource("/1.properties")
// → file:/E:/workspace/Test/bin/1.properties

同理適用：Class.getResourceAsStream() 路徑規則完全一致。

2. ClassLoader.getResource(String path)

TestMain t = new TestMain();
System.out.println(t.getClass().getClassLoader().getResource(""));
System.out.println(t.getClass().getClassLoader().getResource("/")); // null
System.out.println(t.getClass().getClassLoader().getResource("1.properties"));
System.out.println(t.getClass().getClassLoader().getResource("testpackage/2.properties"));

輸出：

file:/E:/workspace/Test/bin/
null
file:/E:/workspace/Test/bin/1.properties
file:/E:/workspace/Test/bin/testpackage/2.properties

關鍵等價關係

TestMain.class.getResource("/") == t.getClass().getClassLoader().getResource("")

即：Class 絕對路徑 = ClassLoader 相對路徑，都指向 ClassPath 根。

3. 同樣適用 `getResourceAsStream()`

兩者的 AsStream 版本路徑解析邏輯與上述完全一致。

常見踩坑場景與避坑指南

錯誤寫法	後果	修正
`clazz.getResource("/config.xml")` 但文件在包內	找不到資源（去根目錄找了）	去掉 `/` 或改用 `clazz.getResource("config.xml")`
`clazz.getClassLoader().getResource("/config.xml")`	返回 `null`	去掉 `/`：`clazz.getClassLoader().getResource("config.xml")`
Spring 中 `classpath:config.xml` vs `classpath*:config.xml`	前者只取第一個，後者合併所有 JAR 中同名資源	多模塊/多 JAR 共存時用 `classpath*:`

最佳實踐建議

統一風格：團隊約定「業務代碼優先用 Class.getResource(\"relative/path\")，框架/工具代碼用 ClassLoader.getResource(\"absolute/path\")」。
測試驗證：單元測試中打印 URL 確認實際解析路徑，特別是打包成 JAR/War 後。
避免硬編碼絕對路徑：不要寫死 file:/E:/xxx，破壞可移植性。
資源文件放置：Maven 標準目錄 src/main/resources 下的文件編譯輸出至 ClassPath 根，包結構對應子目錄。