JAR 文件全解析：從結構到可執行 JAR 創建最佳實踐

JAR 文件本質

JAR（Java Archive）本質是 ZIP 格式壓縮包，唯一區別在於包含 META-INF/MANIFEST.MF 清單文件。對比：

test.zip          test.jar
└─ test/          ├─ META-INF/
   └─ Test.class      └─ MANIFEST.MF
                     └─ test/
                        └─ Test.class

可執行 JAR 創建三步驟

1. 編寫 Manifest 清單文件

創建 manifest.mf（任意位置），關鍵行：

Main-Class: com.example.MainClass

• 類名需包含完整包路徑。
• 該行必須以換行符結尾，否則解析失敗。
• 可添加 Class-Path: lib/dep1.jar lib/dep2.jar 聲明依賴（相對 JAR 路徑）。

2. 目錄結構準備

project-root/
├─ manifest.mf
└─ com/
   └─ example/
      └─ MainClass.class

3. 執行 jar 命令打包

jar cvfm MyApp.jar manifest.mf com

• c 創建，v 顯示過程，f 指定輸出文件，m 引入自定義 Manifest。
• 最後一個參數 com 為打包的根目錄（包含包結構）。

運行與驗證

java -jar MyApp.jar

雙擊運行需系統關聯 .jar 到 javaw.exe（Windows JRE 安裝默認已配置）。

常見坑點與解決

進階：Maven Shade / Assembly 插件

生產項目建議使用 Maven 插件自動化：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-shade-plugin</artifactId>
  <configuration>
    <transformers>
      <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
        <mainClass>com.example.MainClass</mainClass>
      </transformer>
    </transformers>
  </configuration>
</plugin>

優勢：自動合併依賴、處理簽名衝突、生成 Fat JAR（含所有依賴），無需手動管理 Class-Path。

總結

• JAR = ZIP + MANIFEST.MF。
• 可執行 JAR 核心在 Main-Class 屬性。
• 手動打包適合簡單項目；企業級項目請使用 Maven/Gradle 插件自動化。

1. 上一篇文章： Snort 規則編寫核心：content 選項與修飾符深度解析
2. 下一篇文章： Eclipse 代碼自動提示優化：突破 5 字符限制，實現任意字符觸發

Java 相關知識

Eclipse Dali JPA Tools 快速入門：視覺化開發 JPA 實體映射

Eclipse WTP（Web Tools Platform

Java SE 6 Update N 透明與非矩形視窗實戰：AWTUtilities API 深度解析

背景：Consumer JRE 帶來的視覺革命 Java S

JDK 7 核心新特性深度解析：InvokeDynamic、G1、NIO.2 與 Project Coin

發布歷程回顧 JDK 7 歷經 5 年磨合（2006.12

再探 Java 基礎：throw 與 throws 異常拋出機制深度解析

異常處理是 Java 健壯性的基石。throw 與 thro