说起 Java 开发，几乎每个工程师dou会在某个时刻碰到「JAR 包」这三个字。它像一枚小小的邮递员，装载着编译好的字节码、图片资源甚至配置信息，悄然把我们的代码送到 JVM 手里运行。今天我想用一种稍带情绪化的口吻，把这个kan似平淡的技术点重新拼装，让你在阅读的过程中既Neng收获知识，又Neng感受到一点点小惊喜。

一、JAR 包的本质——一个特殊的 ZIP 文件

Ru果把文件系统比作城市街道，那么 JAR 包就是一辆封闭的货车。它采用了业界熟知的 ZIP 压缩算法，只是把压缩后得到的容器取名为 .jar，并在内部约定了一套特有的目录结构和元信息文件。

核心要点：

基于 ZIP： 与普通 zip/rar 没有本质区别，因而Ke以直接使用 Java 自带的 java.util.zip 包进行读取。

META-INF/MANIFEST.MF： 每个 JAR dou会在这一路径下放置一个清单文件，它记录了版本号、主类以及其他自定义属性。

.class 与资源共存： 编译好的字节码和诸如 XML、properties、图片等资源文件全部被打进同一个容器。

目录结构速览

├─ META-INF/
│   └─ MANIFEST.MF
├─ com/example/app/
│   ├─ App.class
│   └─ utils/
│       └─ Helper.class
└─ resources/
    ├─ application.yml
    └─ logo.png

上面的示例展示了Zui常见的布局：META-INF 用来存放清单；业务代码按照包名分层放置；资源文件则随意归类，只要在运行时Neng够被类加载器定位即可。

二、普通 JAR 与可执行 JAR 的分水岭

普通 JAR 往往充当库的角色。它们只提供若干 API，供其他项目通过 Maven/Gradle 引入使用；没有任何「入口」概念。

可执行 JAR 则不一样。当我们在终端敲下 java -jar myapp.jar 时JVM 会先打开这个压缩包，读取其中的 META-INF/MANIFEST.MF, 找到标记为 Main-Class 的属性，然后定位到对应的字节码并调用其静态方法 public static void main 开始执行。

"java -jar" 背后的魔法步骤

打开压缩体：KlassLoader 通过内置 ZipFile 类把 .jar 当成虚拟文件系统挂载。

读取清单：META-INF/MANIFEST.MF 被解析，提取 Main-Class 信息。

定位入口类：KlassLoader 按需加载该类及其依赖。

启动 main 方法：Hello World 或者geng复杂的业务逻辑正式上路。

这套流程kan似简单，却隐藏着 JVM 对类路径与模块化系统的深层次协同。

三、Spring Boot Fat JAR——让“一键启动”成为可Neng

S​pring Boot 为了解决「依赖碎片化」的问题，引入了所谓的「Fat JAR」或「Uber JAR」。它把项目自己的 class 文件以及所有第三方 jar dou塞进同一个压缩包，从而实现「一次构建，随处运行」的理想状态。不过这种“把所有东西dou塞进去”的Zuo法背后有一套专属的启动机制。

META-INF 中不止清单，还藏着 Launcher

S​pring Boot 在清单里写入了类似以下内容：

Main-Class: org.springframework.boot.loader.JarLauncher
Start-Class: com.example.Application
Spring-Boot-Version: 2.7.5

Main-Class 指向的是框架提供的启动器，而真正业务入口则通过自定义属性 Start-Class 标记。当 JVM 执行该 Jar 时会先实例化 Spring 提供的 JarLauncher.

自定义类加载器如何玩转嵌套 JAR

S​pring Boot 把外部依赖放在 /BOOT-INF/lib/xxx.jar, 把项目自己的代码放在 /BOOT-INF/classes/.... 为了让这些嵌套 jar Neng被正常读取，它实现了一个叫Zuo L​aunchedURLClassLoader 的子类加载器：

L​aunchedURLClassLoader 会遍历 BOOT-INF/lib 下所有 jar 文件，将每个 jar 转成 URL 并加入自己的搜索路径；同时也把 BOOT-INF/classes 加入搜索范围。

L​aunchedURLClassLoader 在加载任何类之前，会先检查自身缓存，Ru果找不到再委托给父加载器。这种双向委托确保了框架自身与业务代码之间不会出现冲突。

\end{ul}

※ 上述描述Yi高度抽象化，实际实现细节请参考 Spring 官方源码注释。

四、实战场景：何时该选普通 Jar？何时需要可执行或 Fat Jar？

需求类型	推荐方案
共享库 / 多模块复用	普通 Jar + Maven/Gradle 管理依赖
独立部署 / 跨机器运行	可执行 Jar
微服务 / 容器镜像	Spring Boot Fat Jar 或者使用 Docker 多层镜像

五、写好一个合格 Manifest 的小技巧

#1 明确版本号：`Manifest-Version: 1.0` 是必须项，否则某些老旧工具会报错。

#2 指定入口类：`Main-Class: com.example.MainApp` 必须与实际存在且含有 `public static void main` 方法相匹配，否则 `java -jar` 会抛出 “NoSuchMethodError”。

#3 添加 Class-Path：`Class-Path:` Ke以列出外部 jar 的相对路径，这在不想使用 Fat Jar 而又希望一次性打包多个依赖时非常有用。

#4 自定义属性：`Implementation-Version`, `Built-By` 等信息Ke以帮助运维快速定位问题来源。

六、回顾：从“归档”到“启动”，JAR 包到底干了什么？

核心原理简述： JAR包其实是一种基于 ZIP 压缩技术形成的归档格式，它把编译后的字节码文件以及各种资源统一封装，再借助位于 META-INF/MANIFEST.MF 中的一组元数据指明程序入口。Zui终，这个压缩体被 JVM 所识别，通过自带或自定义的类加载器逐步将内部内容装载进内存，从而完成运行过程。

七、常见问答

A：JDK 自带哪些工具Ke以查kan或编辑 JAR？

- `jar` 命令：创建/geng新/列出 - `zip` / `unzip`：兼容操作 - IDE 插件：IntelliJ IDEA / Eclipse 可视化管理

B：为什么有时候打出来的可执行 Jar 运行报 “Invalid or corrupt jarfile”？

- 常见原因包括 Manifest 编码错误、Main‑Class 拼写错误或压缩过程中文件损坏。建议先用 `jar tf xxx.jar` 检查目录完整性，再用 `javap -classpath xxx.jar MainClass` 验证入口是否真的存在。

C：Fat Jar 与传统多 jar 方式相比，有哪些性Neng影响？

- 优点：一次下载即可运行，无需额外解析依赖树；部署极简。 - 缺点：整体体积geng大，占用磁盘空间；启动时需要自定义类加载器扫描嵌套 jar，可Neng略微增加冷启动时间。但对于微服务和容器化部署来说这种额外开销往往Ke以接受甚至被忽略。

八、结束语 —— 把握细节，让你的 Java 项目geng轻盈、geng可靠！

TikTok 那句流行语说得好：“技术不只是硬核，geng是一种生活方式”。当你掌握了上述关于 JAR 包结构与工作机理的一系列细节点，你就Neng在日常开发中geng加从容地切换库依赖、打包发布乃至排查异常。别忘了把每一次构建dou当作一次“小旅行”，让代码在压缩与解压之间找到Zui优雅的位置吧！祝你玩转 Java 世界，每一次 "java -jar" douNeng顺畅无阻 🚀.

© 2026 技术笔记 | 本文采用 CC BY-NC-SA 4.0 协议发布，仅供学习交流。

---