Java JAR 打包完整教學：命令行與 Eclipse 兩種方式詳解

前言

將 Java 專案打包為可執行 JAR 是部署的基本技能。本文涵蓋命令行 jar 指令與 Eclipse 圖形化導出，並說明如何處理外部依賴庫。

1. 命令行打包

基本語法

jar {ctxui}[vfm0Mi] [jar-file] [manifest-file] [-C dir] files...

常用範例

# 將 Foo.class, Bar.class 打包成 classes.jar
jar cvf classes.jar Foo.class Bar.class

# 使用現有 manifest，將 foo/ 目錄下所有檔案打包
jar cvfm classes.jar mymanifest -C foo/ .

執行 JAR

java -jar test.jar
# 將輸出導向 log.txt
java -jar test.jar > log.txt

2. Eclipse 圖形化導出

情況一：無外部依賴

1. 右鍵專案 → Export → Java → JAR file
2. 選擇匯出路徑與檔名
3. 下一步 → 下一步 → 選擇 Main class → Finish

情況二：含外部 JAR 依賴（需手動配置 Manifest）

1. 先產生 Manifest 檔：Export → JAR file → 勾選 Generate the manifest file → Save in workspace（如 /MyProject/MANIFEST.MF）
2. 編輯產生的 MANIFEST.MF：

Manifest-Version: 1.0
Main-Class: com.example.Main
Class-Path: lib/jxl.jar lib/other.jar

3. 再次 Export → JAR file → 勾選 Use existing manifest from workspace → 選擇剛建立的 Manifest → Finish
4. 確保 Class-Path 中的 JAR 與輸出 JAR 放在同一目錄

3. 進階：Maven/Gradle 專案建議

現代專案建議使用建構工具自動打包：

• Maven：mvn package（配合 maven-shade-plugin 或 maven-assembly-plugin 產生 Fat JAR）
• Gradle：./gradlew shadowJar（需 com.github.jengelman.gradle.plugins.shadow 外掛）

4. 常見坑點

• Manifest 最後一行必須換行，否則不生效。
• Class-Path 路徑以空格分隔，相對路徑基於 JAR 所在目錄。
• Java 9+ 模組化系統可能需額外配置 --add-modules。