从JAR到EXE：使用exe4j为Maven项目打造独立Windows应用（附JRE打包实战）

1. 为什么需要将JAR转为EXE

很多Java开发者都遇到过这样的场景：你精心开发了一个桌面应用，用Maven打包成JAR文件后，兴冲冲地发给朋友测试，结果对方双击后毫无反应。这不是你的代码有问题，而是对方电脑可能根本没装Java环境。

Java程序依赖JVM运行的特性，既是优势也是痛点。优势在于"一次编写，到处运行"，痛点在于用户必须预先配置Java环境。对于普通Windows用户来说，让他们先安装JDK/JRE再运行程序，体验实在太不友好。想象一下，你给客户发了个财务软件，对方还要先折腾半小时环境配置，这体验能好吗？

这时候就需要将JAR转换为EXE。EXE文件对Windows用户来说就像.exe一样自然——双击就能运行，不需要任何前置知识。我在给某医院开发病历管理系统时就深有体会：医生们根本不懂什么是Java环境，他们只关心点击图标后程序能不能立即工作。

2. 准备可执行JAR文件

2.1 配置Maven Shade插件

要让JAR文件能独立运行，首先得确保它包含所有依赖。普通的mvn package打出来的JAR是不带依赖的，这就是为什么你双击JAR没反应，但用java -jar却能运行。

在pom.xml中添加shade插件配置：

xml复制<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.3.0</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>com.your.package.MainClass</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

这里有个坑我踩过：<mainClass>必须是你程序入口类的全限定名。有次我写成了Main.java，结果打包后死活运行不了，排查半天才发现问题。

2.2 验证JAR可执行性

打包完成后，别急着进行下一步，先用命令行测试：

bash复制java -jar target/your-app.jar

如果运行正常，你会看到程序启动。这一步看似简单，但能避免后续很多问题。我曾经跳过测试直接转EXE，结果exe4j报错时完全不知道是JAR本身的问题还是转换工具的问题。

3. 使用exe4j转换EXE

3.1 安装与基础配置

exe4j的安装过程很简单，但有几个关键点需要注意：

1. 下载时选择与系统匹配的版本（32位/64位）
2. 安装路径不要有中文或空格
3. 首次启动需要输入许可证密钥（网上可以找到可用的）

新建配置时，重点注意这几个选项：

• "JAR in EXE"模式：这是我们需要的
• 输出目录：建议新建一个专门存放打包产物的文件夹
• 程序类型：GUI程序选"Windows GUI"，控制台程序选"Console"

3.2 关键参数设置

在"Java invocation"选项卡中：

1. 添加你的JAR文件
2. 指定主类（会自动读取MANIFEST.MF中的配置）
3. 在VM参数中设置-Xmx等内存参数

这里有个实用技巧：如果你不确定用户电脑的配置，可以设置：

code复制-Xmx512m -Xms128m

这样既能保证基本运行，又不会占用过多资源。

3.3 JRE配置详解

这是最关键的步骤，也是最多人踩坑的地方。exe4j提供了三种JRE指定方式：

1. 搜索注册表（不推荐，用户可能没装JRE）
2. 指定目录（推荐）
3. 打包JRE（最佳方案）

对于JDK 8及以下版本，直接把JDK中的jre文件夹复制到exe同级目录即可。但JDK 9+的情况就复杂了...

4. JDK 11+的JRE打包实战

4.1 为什么JDK 11没有JRE

从JDK 9开始，Oracle移除了独立的JRE。这不是功能缺失，而是模块化带来的改变。你可以用jlink工具自定义运行时环境，只包含程序需要的模块，大大减小分发体积。

4.2 使用jlink生成精简JRE

在JDK安装目录下执行：

bash复制bin\jlink.exe --module-path jmods --add-modules java.base,java.desktop --output myjre

这个命令会生成一个只包含java.base和java.desktop模块的JRE。但问题来了：你怎么知道程序需要哪些模块？

4.3 模块依赖分析

使用jdeps工具分析依赖：

bash复制jdeps --list-deps your-app.jar

输出会显示所有依赖的模块。把这些模块都加到jlink命令中。比如我的一个Swing项目需要这些模块：

bash复制--add-modules java.base,java.desktop,java.sql,java.xml

4.4 常见问题解决

如果运行时出现ClassNotFoundException，说明漏了模块。这时有两个选择：

1. 重新jlink，添加缺失的模块
2. 直接使用完整JDK（不推荐，体积会大很多）

我建议在开发机上先用完整JDK测试，确认运行无误后再用jlink精简。

5. 高级技巧与优化建议

5.1 添加程序图标

想让你的EXE更专业？准备一个.ico文件，在exe4j的"Executable info"选项卡中设置。图标尺寸建议包含256x256、64x64、32x32等多种分辨率。

5.2 版本信息配置

在"Version info"选项卡中可以设置：

• 文件版本
• 产品版本
• 公司名称
• 版权信息

这些信息会显示在EXE文件的属性对话框中，让程序看起来更正规。

5.3 减少启动时间

Java程序启动慢是个老问题。通过以下方法可以优化：

1. 使用jlink时只包含必要模块
2. 在exe4j中启用"加速类加载"选项
3. 适当增加初始堆内存(-Xms)

5.4 处理控制台程序

如果你的Java程序是控制台应用，记得：

1. 在exe4j中选择"Console"类型
2. 勾选"Keep console open"防止窗口一闪而过
3. 重定向System.out/err到文件方便调试

6. 替代方案对比

除了exe4j，还有其他几种打包方案：

我个人的选择标准：

• 简单项目用Launch4j
• 商业项目用exe4j
• 新项目考虑JPackage（毕竟是官方方案）

7. 实际项目经验分享

去年给某学校开发考试系统时，我遇到了一个典型问题：教室电脑配置五花八门，有的甚至还在用Windows 7。通过exe4j打包时，我特别注意了以下几点：

1. 使用JDK 8兼容模式编译
2. JRE选择1.8版本
3. 在低配虚拟机中测试打包结果
4. 准备32位和64位两个版本

最终交付的EXE文件在全部200多台电脑上都能正常运行，这就是工具选型得当的价值。

另一个经验是：永远保留构建脚本。我在项目的build目录下存放了：

• 完整的exe4j配置文件（.exe4j）
• jlink命令脚本
• 测试用的批处理文件

这样下次更新时，几分钟就能重新打包，不用从头配置。