Eclipse 打包可執行 JAR 完整指南：從基本導出到 FatJar 依賴合併與批次檔啟動

前言

在 Java 開發中，將專案打包成可獨立執行的 JAR 檔是部署與分發的常見需求。Eclipse 內建的匯出功能雖方便，但處理第三方依賴庫時往往力有未逮。本文將詳細說明三種情境的打包策略：無外部依賴的基本導出、引用外部 JAR 時的建置路徑設定、以及使用 FatJar 外掛一鍵合併所有依賴；最後補充如何撰寫 .bat 批次檔實現雙擊即運行。

一、無外部依賴：Eclipse 內建匯出功能

1. 選單列點擊 File → Export。
2. 展開 Java 資料夾，選擇 Runnable JAR file，按 Next。
3. Launch configuration 下拉選單選擇專案的主類（含 main 方法的類），否則執行時會報 Failed to load Main-Class manifest attribute 錯誤。
4. 其餘保持預設，連續點擊 Finish 即可在指定目錄產生可執行 JAR。

二、專案依賴第三方 JAR：先設定 Build Path 再用 FatJar

步驟 1：將外部 JAR 加入建置路徑

1. 專案右鍵 → Properties → Java Build Path → Libraries 頁籤。
2. 點擊 Add External JARs... 選取所有需引用的第三方 JAR 檔，確定。

步驟 2：安裝 FatJar 外掛

1. 下載 fatjar-plugin（或 fatjar.eclipse.plugin），將解壓後的 plugins、features 資料夾複製到 Eclipse 安裝目錄下對應資料夾。
2. 重啟 Eclipse。

步驟 3：建置 Fat JAR

1. 專案右鍵 → Build Fat JAR。
2. 在 Main-Class 欄位選擇主類，按 Next。
3. File List 區域會自動列出專案類別與所有引用的第三方類別，確認無誤後按 Finish。
4. 專案根目錄下即會產生 xxx_fat.jar，雙擊即可直接運行。

三、撰寫 .bat 批次檔實現雙擊啟動

在 JAR 所在目錄建立文字檔，命名為 run.bat（名稱任意，副檔名必須為 .bat），內容如下：

java -jar your-jar-name.jar

雙擊 run.bat 即可啟動程式。

常見問題與優化

1. 提示「java 不是內部或外部命令」：需將 JDK 安裝目錄下的 bin 路徑（含 java.exe、javaw.exe）加入 Windows 環境變數 Path。
2. 不想顯示黑色命令視窗：將批次檔內容改為 start javaw -jar your-jar-name.jar（使用 javaw 而非 java）。
3. 除錯需保留視窗查看錯誤訊息：在指令後加 pause，例如：

   start java -jar your-jar-name.jar
   pause

總結

無依賴專案用內建匯出最快；有依賴時，設定 Build Path + FatJar 是最省事且穩健的方案。搭配簡單的 .bat 腳本，即可讓使用者像執行原生應用程式一樣雙擊運行 Java 程式。