🧩 Java 新手教學：什麼是 JAR 檔？一步步教你把 Java 程式打包成可執行檔！

 💡 一、什麼是 JAR 檔？

很多初學者寫完 Java 程式後，會疑惑：「為什麼我的程式要靠 IDE 執行？能不能直接雙擊打開？」
答案是可以的——只要把它「打包」成一個 .jar 檔！

JAR（Java ARchive） 就像是把你的程式、圖片、設定檔、函式庫等等都壓縮進一個容器。
有了它，你的程式就能在任何裝好 Java 的電腦上輕鬆執行。

---

🧰 二、打包前的準備

在開始打包前，你需要：

1. 已經寫好並成功執行的 Java 程式。

2. 電腦中安裝了 Java JDK（Java Development Kit）。
   打開終端機或命令提示字元輸入：

   java -version
   javac -version
   

   若能顯示版本號，就代表安裝成功。

---

🏗️ 三、使用命令列打包成 JAR 檔

這是最經典的方式，也是了解打包原理的第一步。

假設你有一個主程式叫做：

com.example.Main

第一步：建立 MANIFEST.MF

這個檔案負責告訴 Java：「執行時要跑哪一個主類別」。

內容如下（最後一行要留空白）：

Manifest-Version: 1.0
Main-Class: com.example.Main

第二步：使用 jar 指令打包

jar cfm MyProgram.jar MANIFEST.MF -C out .

這行指令的意思是：

• c 建立新 JAR

• f 指定輸出檔名

• m 指定 MANIFEST

• -C out . 表示從 out 資料夾取出所有內容打包

完成後，你會得到一個 MyProgram.jar。

第三步：執行 JAR

java -jar MyProgram.jar

若看到你的程式成功執行，恭喜你完成了打包！

---

🧩 四、使用開發工具（Eclipse / IntelliJ）快速打包

✅ 在 Eclipse 中：

1. 右鍵點選專案 → Export

2. 選擇 Java → Runnable JAR File

3. 指定主程式（Main Class）

4. 選擇輸出路徑

5. 點「Finish」即可！

---

✅ 在 IntelliJ IDEA 中：

1. 打開 File → Project Structure → Artifacts

2. 按「+」→ JAR → From modules with dependencies

3. 選主程式類別

4. 點「Build → Build Artifacts → Build」

5. JAR 會出現在 out/artifacts/ 資料夾中。

---

⚙️ 五、使用 Maven 或 Gradle 自動打包（進階用法）

若你的專案使用 Maven：

mvn clean package

它會自動在 target/ 資料夾中產生 .jar。

若是使用 Gradle：

gradle build

結果會放在 build/libs/。

---

💥 六、常見錯誤與解法

錯誤訊息	原因	解法
no main manifest attribute	沒有設定主類別	檢查 MANIFEST.MF 內容
Could not find or load main class	程式包名錯誤	確認主類別全名
找不到外部 library	jar 沒有打包依賴	使用「fat jar」插件（如 Maven Shade Plugin）

---

🎯 七、結語：打包 JAR 是 Java 工程師的基本功

無論你是剛學 Java，還是準備部署到伺服器上，「了解如何打包 JAR」是成為專業工程師的重要一步。
這不只是壓縮檔，而是 讓你的程式能夠被任何人輕鬆使用的關鍵。