Java 獲取項目/類/文件路徑的 5 種姿勢：從 ClassLoader 到 System Property 完全指南

Java 獲取項目/類/文件路徑的 5 種姿勢：從 ClassLoader 到 System Property 完全指南

路徑獲取是配置文件讀取、資源加載、日志輸出的基礎操作。本文對比 5 種主流方式的返回值差異、適用場景與避坑指南，助你精準選型。

五大方法對比表

關鍵差異解析

• 方法 1/3 依賴 ClassLoader，返回 URL，路徑含 file:/ 前綴、URL 編碼空格 %20，需 URLDecoder.decode(url, "UTF-8") 解碼
• 方法 2/4 返回文件系統原生路徑，方法 4 最穩健：不受類加載器影響，單元測試/打包部署/Jenkins 構建均一致
• 方法 5 包含所有依賴 Jar 路徑，用於診斷 NoClassDefFoundError、ClassCastException (同類多載)

最佳實踐模板

public class PathUtils {
    // 1. 獲取專案根目錄 (推薦)
    public static String getProjectRoot() {
        return System.getProperty("user.dir");
    }
    // 2. 讀取 classpath 資源 (Spring 無侵入)
    public static InputStream getResourceAsStream(String path) {
        return Thread.currentThread().getContextClassLoader().getResourceAsStream(path);
    }
    // 3. 獲取當前類同級資源
    public static URL getSiblingResource(Class clazz, String name) {
        return clazz.getResource(name);
    }
}

避坑清單

1. 不要在打包後的 Jar 內用 new File() 讀取資源，改用 ClassLoader.getResourceAsStream()
2. Windows 路徑分隔符 \、Linux /，統一用 File.separator 或 Paths.get()
3. IDE 運行時 user.dir 指向模塊目錄，Maven 打包啟動指向 Jar 所在目錄，相對路徑邏輯需兼容