对于Java开发者来说，将程序打成可执行Jar包是交付部署的核心环节，**通过maven或gradle自动构建可规避手动打包的依赖缺失问题**，**规范MANIFEST.MF配置是生成可执行Jar包的核心前提**。其实只要掌握打包的底层逻辑和主流工具的操作规范，就能快速生成稳定的可执行Jar包，适配Windows、Linux等多平台部署需求。

## 一、先搞懂可执行Jar包的底层逻辑
可执行Jar包本质是包含特定配置规则的ZIP格式归档文件，它和普通依赖Jar包的核心区别在于内置了MANIFEST.MF配置文件。这个配置文件会明确指定程序的主类入口、依赖路径等关键信息，让JVM可以直接识别并启动程序，无需手动指定启动参数。不难发现，《2023 Java生态系统现状报告》（JetBrains）显示，72%的Java项目选择生成可执行Jar包作为交付格式，比2021年提升18个百分点，核心原因就是它简化了跨平台部署流程，无需额外配置项目依赖环境。

值得注意的是，可执行Jar包的运行逻辑并不复杂：当用户执行java -jar命令时，JVM会先读取MANIFEST.MF文件中的Main-Class字段，定位到包含main方法的主类，再加载配置中声明的依赖资源，最终启动程序。如果缺少MANIFEST.MF配置或配置错误，JVM会直接抛出“Could not find or load main class”错误，这也是新手打包时最容易踩坑的环节。

## 二、手动打包可执行Jar包的完整流程
手动打包适合小型Demo项目或需要自定义Jar包结构的场景，全程无需依赖构建工具，能帮开发者清晰理解打包的底层逻辑。不过手动打包的操作流程相对繁琐，容易出现依赖遗漏的问题，不推荐在企业级项目中大规模使用。
### 1. 提前整理项目的依赖与主类信息
在手动打包前，开发者需要先编译所有Java源文件，将编译后的class文件统一放在指定目录下，比如target/classes文件夹。同时要列出项目依赖的所有第三方Jar包路径，确保这些依赖会被正确加载。还要确认包含main方法的主类全路径，比如com.example.demo.Application，避免后续配置出现路径错误。

### 2. 配置标准MANIFEST.MF文件
MANIFEST.MF文件是可执行Jar包的核心配置文件，需要放在META-INF文件夹下。配置文件中必须包含Main-Class字段，用来指定主类的全路径；如果项目依赖了第三方Jar包，还需要添加Class-Path字段，声明依赖Jar包的相对路径。值得注意的是，MANIFEST.MF文件的最后一行必须留空，否则JVM会无法识别配置内容。

### 3. 使用Jar命令完成手动打包
整理好所有文件后，可以使用JDK自带的jar命令完成打包操作，常用的命令格式为`jar cvfm demo.jar META-INF/MANIFEST.MF -C target/classes .`。其中参数c表示创建新Jar包，v表示显示打包过程，f表示指定输出Jar包名称，m表示指定MANIFEST.MF配置文件。执行命令后，终端会显示打包的文件列表，确认所有class文件和配置文件都已正确归档即可。

## 三、Maven自动化打包的最优实践
Maven是当前企业级Java项目最常用的构建工具，它可以自动处理依赖管理、编译和打包流程，大幅降低手动操作的出错率。《2024 企业级Java构建工具选型白皮书》（InfoQ）数据显示，83%的企业级Java项目使用Maven作为主构建工具，自动化打包占比超90%，成为可执行Jar包打包的主流方案。

### 1. 配置pom.xml打包插件参数
Maven默认打包生成的是普通依赖Jar包，想要生成可执行Jar包，需要在pom.xml文件中配置专用的打包插件。常用的插件有maven-assembly-plugin和spring-boot-maven-plugin，两者的适用场景和打包逻辑存在明显差异，开发者可以根据项目类型选择合适的插件：
| 插件名称                | 核心功能                     | 依赖打包方式       | 配置复杂度 | 适合场景               |
|-------------------------|------------------------------|--------------------|------------|------------------------|
| maven-assembly-plugin   | 自定义打包结构与依赖规则     | 外置依赖/内嵌依赖可选 | 中等       | 普通Java项目快速打包   |
| spring-boot-maven-plugin | SpringBoot项目专属打包工具   | 内嵌全部依赖至Jar包内部 | 低         | SpringBoot微服务项目   |

### 2. 处理依赖打包的两种模式
Maven打包可执行Jar包支持两种依赖处理模式：内嵌依赖和外置依赖。内嵌依赖模式会将所有第三方Jar包打包到可执行Jar包内部，生成的Jar包体积较大，但运行时无需额外指定依赖路径，适合独立部署的小型服务；外置依赖模式只会打包项目的class文件，依赖Jar包需要单独放置在指定目录，生成的Jar包体积较小，适合需要共享依赖的分布式项目。

### 3. 本地打包与远程仓库发布
完成pom.xml配置后，执行mvn package命令即可在target目录下生成可执行Jar包。如果需要将Jar包发布到私有或公开的Maven仓库，可以执行mvn deploy命令，将打包好的Jar包自动上传到配置的仓库地址，便于团队成员统一拉取使用。值得注意的是，发布前需要确认仓库的权限配置，避免出现上传失败的问题。

## 四、Gradle自动化打包的落地方案
Gradle是近年来快速崛起的Java构建工具，它结合了Maven的依赖管理优势和Ant的灵活配置特性，打包速度和增量构建效率优于Maven，适合大型Java项目的自动化构建流程。
### 1. 配置build.gradle打包脚本
在Gradle项目中，开发者需要在build.gradle文件中引入application插件，配置mainClassName字段指定主类全路径，比如mainClassName = 'com.example.demo.Application'。同时可以配置Jar包的输出名称、版本号等参数，让打包结果更符合项目交付规范。

### 2. 实现依赖的按需打包
Gradle支持通过shadow插件实现依赖的内嵌打包，将所有第三方依赖整合到可执行Jar包内部。只需在build.gradle中引入com.github.johnrengelman.shadow插件，执行./gradlew shadowJar命令即可生成包含所有依赖的可执行Jar包。其实这种打包方式和SpringBoot的内置依赖打包逻辑类似，都能实现一键启动的部署效果。

### 3. 多环境打包参数配置
Gradle支持通过命令行参数或配置文件指定打包的环境变量，比如开发环境、测试环境和生产环境的配置文件分离。开发者可以通过productFlavors功能定义不同环境的打包规则，无需手动修改配置文件就能生成适配不同环境的可执行Jar包，大幅提升了多环境部署的效率。

## 五、可执行Jar包的调试与问题排查
打包完成后，很多开发者会遇到Jar包无法启动、依赖缺失等问题，学会快速排查和调试是保障项目顺利交付的关键能力。
### 1. 常见打包失败的核心原因
新手打包时最常遇到的问题有三类：一是主类路径配置错误，JVM无法找到包含main方法的类；二是依赖Jar包路径配置错误，导致运行时ClassNotFoundException；三是Jar包权限不足，部分系统需要手动赋予可执行权限。不难发现，这些问题大多源于配置细节的疏漏，只要对照配置文件逐一核对就能快速解决。

### 2. 验证可执行Jar包的有效性
完成打包后，可以通过三个步骤验证可执行Jar包的有效性：首先执行java -jar demo.jar命令，查看程序是否能正常启动；其次执行jar tf demo.jar命令，查看Jar包内部的文件结构，确认class文件和MANIFEST.MF配置文件是否存在；最后执行java -cp demo.jar com.example.demo.Application命令，手动指定主类启动程序，排查主类配置是否存在问题。

### 3. 日志输出的优化方案
如果可执行Jar包启动后没有输出日志，或日志内容不完整，可以通过配置JVM参数调整日志输出级别，比如添加-Dlogging.level.root=INFO参数，让程序输出详细的运行日志。也可以将日志输出到指定文件，使用java -jar demo.jar > app.log命令，将控制台输出的日志保存到本地文件，方便后续问题排查。

## 六、跨平台可执行Jar包的优化策略
生成可执行Jar包后，还可以通过一系列优化操作提升它的运行效率和部署体验，适配不同操作系统的运行需求。
### 1. 压缩Jar包体积的有效方法
大型Java项目的可执行Jar包体积通常会超过100MB，增加了传输和存储成本。开发者可以通过ProGuard工具对代码进行混淆和压缩，移除未使用的类和方法，**经过混淆压缩的可执行Jar包体积可减少40%-60%**，同时还能提升代码的安全性，防止代码被反编译泄露。

### 2. 适配不同操作系统的JVM参数
不同操作系统的资源限制存在差异，开发者可以针对Windows、Linux等系统配置不同的JVM参数。比如在Linux系统中，可以添加-Xmx参数调整JVM的最大堆内存，适配服务器的硬件资源；在Windows系统中，可以添加-Dfile.encoding=UTF-8参数，解决中文乱码的问题。

### 3. 签名可执行Jar包保障安全性
对于需要公开分发的可执行Jar包，开发者可以使用JDK自带的jarsigner工具对Jar包进行数字签名，防止Jar包被恶意篡改。签名后的Jar包会包含开发者的数字证书，用户可以通过jarsigner命令验证签名的有效性，确认Jar包来源的可信度。

1. 《2023 Java生态系统现状报告》，JetBrains，2023
2. 《2024 企业级Java构建工具选型白皮书》，InfoQ，2024

确保Java程序已经编译成.class文件，并且所有依赖的资源文件已经放入正确的目录结构内。同时，创建一个清晰的项目目录，方便后续打包操作。

准备Java程序打包的必要步骤

在将Java程序打包成JAR文件之前，需要做哪些准备工作？

如何准备Java程序以便打包成JAR文件？

在打包过程中，需要创建一个Manifest文件（通常命名为MANIFEST.MF），并在其中添加Main-Class属性，指定包含main方法的主类全名，保证JAR包可被直接执行。

使用MANIFEST.MF文件指定主类

在打包可执行JAR时，如何指定程序的入口点？

创建可执行JAR包时需要配置哪个文件？

通过命令行运行类似于jar cfm MyApp.jar MANIFEST.MF -C bin/ . 的命令，将编译好的class文件和Manifest文件一起打包成JAR。其中bin/是存放class文件的目录。

使用jar命令打包可执行JAR文件

使用命令行如何创建一个包含入口点的JAR包？

有哪些常用命令可以用来打包可执行的JAR文件？

PingCodeDocs

本文详细讲解了Java可执行Jar包的打包底层逻辑，涵盖手动打包、Maven自动化打包和Gradle自动化打包的完整流程，对比了不同打包工具的适用场景，同时分享了可执行Jar包的调试技巧与跨平台优化策略，帮助开发者快速生成稳定适配多平台的可执行Jar包，规避常见打包风险。

如何将java程序打成可执行的jar包

用户关注问题