Eclipse 中圖片路徑配置：相對路徑失效的解決方案

問題現象

Eclipse 圖形界面程序中，圖片放在 `src/icon/xxx.png`，代碼用相對路徑 `"icon/xxx.png"` 無法顯示；絕對路徑正常。

根本原因

• Java 應用運行時的工作目錄是項目根目錄，而非 `src` 目錄
• 編譯後 `.class` 文件在 `bin/` 或 `target/classes/`，相對路徑基於此處解析
• 資源文件需放在 Classpath 下，通過 `ClassLoader` 獲取

正確做法：作為資源加載

方法一：ClassLoader.getResourceAsStream（推薦）

// 圖片放在 src/main/resources/icon/xxx.png (Maven) 或 src/icon/xxx.png
InputStream is = getClass().getClassLoader().getResourceAsStream("icon/xxx.png");
// 或
InputStream is = getClass().getResourceAsStream("/icon/xxx.png"); // 絕對路徑從 classpath 根

Image image = ImageIO.read(is);

方法二：獲取項目根路徑拼接（不推薦，打包後失效）

String basePath = System.getProperty("user.dir"); // 項目根目錄
String imgPath = basePath + "/src/icon/xxx.png"; // 僅開發環境有效
// 打包成 jar 後完全失效

方法三：Swing/ImageIcon 直接加載

// 從 classpath 根加載
ImageIcon icon = new ImageIcon(getClass().getResource("/icon/xxx.png"));
JLabel label = new JLabel(icon);

Eclipse 專項配置

1. 右鍵項目 → Properties → Java Build Path → Source
2. 確保包含圖片的文件夾（如 `src`）被標記為 Source Folder
3. 或創建專門資源文件夾 `resources`，加入 Build Path
4. 確保輸出目錄包含該資源（默認會複製到 `bin/`）

Maven 標準結構

src/
├── main/
│   ├── java/          # Java 源碼
│   └── resources/     # 資源文件（推薦放這裡）
│       └── icon/
│           └── xxx.png

編譯後自動複製到 `target/classes/icon/xxx.png`，Classpath 直接可訪問。

調試技巧

// 打印實際加載路徑
URL url = getClass().getResource("/icon/xxx.png");
System.out.println("圖片加載路徑: " + url);
// 輸出示例: file:/D:/workspace/project/bin/icon/xxx.png
// 或: jar:file:/app.jar!/icon/xxx.png

總結

• 圖片等資源放入 Source Folder / resources，進入 Classpath
• 用 ClassLoader.getResource / getResourceAsStream 加載
• 避免文件系統相對路徑，打包部署後會失效
• Maven 項目遵循標準目錄結構