简介这份资源面向需要将 Java 工程打包为脱离 JDK 环境独立运行程序的开发者尤其适合不熟悉 exe4j 配置流程或遇到可执行文件启动异常的人群。内容围绕 jar 转 exe 的完整链路展开涵盖 Eclipse 导出 jar、exe4j 安装与 License 填写、JAR EXE mode 选择、依赖 jar 引入、Java 版本与精简 JRE 搜索路径配置等关键环节并针对生成后程序一闪而过的问题给出在 main 方法末尾加入 Thread.sleep 的排查思路。资源包共 1 个 docx 文档约 925KB以图文步骤形式记录操作要点便于对照实践。目前已有 1253 人学习下载适合作为 Java 桌面程序分发与部署的参考材料。1. 从一台没装 JDK 的 Windows 机器说起exe4j 打包 jar 的真实价值上周帮一个做工业上位机的小团队看问题他们用 Java 写了个串口采集工具在自己开发机上跑得好好的结果拷到车间那台只装了 Win7 的工控机上双击直接弹窗报错——不是缺 Java 就是版本对不上。这种场景其实特别常见Java 工程写完了但目标机器上没装 JDK甚至没装 JRE你总不能要求现场操作工去配环境变量。exe4j 就是解决这个问题的它把 jar 包、依赖库、一个精简 JRE 一起塞进一个 exe 里双击就能跑目标机器不需要任何 Java 环境。这篇笔记不讲空泛概念只拆我实际打包时怎么选模式、怎么配 search sequence、怎么处理那个经典的“一闪而过”以及哪些参数改错了会让你白忙一晚上。适合手上有 Eclipse 或 IDEA 工程、需要交付给非技术用户的 Java 开发者。2. 打包前的 jar 生成与依赖梳理别让 ClassNotFound 在 exe 里重演2.1 从 Eclipse 导出 jar 的两种路径与选择依据很多人以为 exe4j 是第一步其实真正的第一步是把工程导成可运行的 jar。Eclipse 里右键 Export 之后会看到两个容易混淆的选项JAR file 和 Runnable JAR file。前者只打包你勾选的源码编译结果后者会把依赖库一起打进去或者生成一个带 Class-Path 的 MANIFEST。我一般会分两种情况处理如果项目依赖只有两三个第三方 jar用 JAR file 导出主工程然后在 exe4j 里手动把依赖加进去这样后续换依赖版本不用重新导出如果依赖有十几个甚至几十个直接用 Runnable JAR file 的 “Extract required libraries into generated JAR” 模式一步到位省得在 exe4j 里一个个点加号。导出时的几个关键勾选Export generated class files and resources 必选Export Java source files and resources 不要选选了 exe 体积会大一圈Compress the contents of the JAR file 看情况——压缩后 jar 小但 exe4j 读取时多一层解压启动会慢个几百毫秒工控机场景我通常不压。下面是一个典型的导出后目录结构你导完可以对照检查# 导出后的工程目录示意 MyProject/ ├── src/ # 源码目录不参与打包 ├── bin/ # 编译输出导出时勾选的就是这里 │ └── com/example/Main.class ├── lib/ # 第三方依赖手动管理时用 │ ├── serialport.jar │ └── log4j.jar └── MyProject.jar # 最终导出的主 jar逻辑说明exe4j 最终认的是 jar 里的 .class 文件和 MANIFEST 里的 Main-Class。如果你导出时没指定 Main-Classexe4j 那一步会让你手动填但更稳妥的做法是在 Eclipse 导出向导里就选好主类这样 MANIFEST 里会写死Main-Class: com.example.Main后面少一个出错点。参数上注意JAR file 导出时 “Options” 里的 “Save the description of this JAR in the workspace” 建议勾上下次改依赖不用重新选一遍。2.2 依赖 jar 的收集与 MANIFEST 的 Class-Path 写法如果走手动加依赖的路线你得先确认所有依赖 jar 都齐了。Eclipse 里可以在 Java Build Path 的 Libraries 标签下看到全部引用但注意User Libraries 里的 jar 和 Web App Libraries 里的不会自动出现在导出列表里得手动勾。我习惯在工程根目录建一个lib文件夹把所有第三方 jar 拷进去然后在 MANIFEST.MF 里写相对路径Manifest-Version: 1.0 Main-Class: com.example.Main Class-Path: lib/serialport.jar lib/log4j.jar这里有个血泪经验Class-Path 里的路径分隔符在 Windows 下用空格不是分号也不是逗号而且路径是相对于 jar 文件所在目录的不是相对于 exe。如果你在 exe4j 里又用加号添加了一遍依赖MANIFEST 里的 Class-Path 会被忽略两者选其一就行重复添加反而可能因为版本冲突报 NoSuchMethodError。常见做法是依赖少就 MANIFEST 写清楚依赖多就全交给 exe4j 的加号管理别混着来。3. exe4j 核心配置逐屏拆解JAR EXE mode 与 search sequence 的配合3.1 模式选择与 License 填写后的第一屏打开 exe4j 之后如果 License 已经填过就直接 Next没填就点 Change License 输入。第一屏是模式选择四个选项里只有 “JAR in EXE mode” 是我们要的——它把 jar 嵌进 exe 的启动器里而不是把 class 文件重新编译成原生代码。另外三个模式Regular mode、Service mode 等要么需要额外配置要么不适合桌面双击场景。选完 Next 之后是项目名和输出目录输出目录建议单独建一个dist文件夹别和源码混在一起否则清理时容易误删。接下来几屏是 exe 的基本信息Executable name 填你要生成的 exe 名字比如DataCollector.exeIcon 可以选一个 .ico 文件不选就是默认图标Output directory 就是刚才那个 dist 路径。这些都不影响功能但 exe 名字别用中文某些工控机的杀毒软件会对中文名 exe 误报。再 Next 就是重头戏——配置 jar 和依赖。3.2 添加主 jar 与依赖 jar 的加号操作细节这一屏左边是 “Classpath” 列表右边有加号按钮。点加号会弹出 Archive selection 对话框让你选 jar 文件。这里有个容易翻车的地方如果你选的是 Runnable JAR file 导出的那个包含所有依赖的大 jar就只需要加这一个如果你选的是普通 JAR file就得把主 jar 和lib下所有依赖 jar 都加进来。加的时候注意顺序——主 jar 放最上面依赖放下面exe4j 会按列表顺序搜索类顺序错了可能加载到旧版本的类。# exe4j 中 Classpath 列表的推荐顺序 MyProject.jar # 主工程必须第一 lib/serialport.jar # 串口依赖 lib/log4j.jar # 日志依赖 lib/commons-lang3.jar # 工具库逻辑说明exe4j 在启动时会按 Classpath 列表从上到下构建一个类加载器如果两个 jar 里有同名类上面的会覆盖下面的。参数上每个 jar 条目右边有个 “Native lib” 勾选框只有包含 JNI 本地库的 jar 才需要勾比如某些串口库、数据库驱动普通 jar 勾了反而可能因为找不到 .dll 报错。加完所有 jar 之后点 Main class 右边的 “...” 按钮选中你的主类exe4j 会自动从主 jar 的 MANIFEST 里读如果读不到就手动输入全限定名。3.3 JRE 版本填写与 search sequence 的路径策略Next 之后是 JRE 配置屏。这里要填 “Minimum Java version” 和 “Maximum Java version”比如你编译时用的是 Java 8就填 1.8 和 1.8或者 1.8 到 1.8.*。填宽了可能匹配到不兼容的 JRE填窄了目标机器上找不到就报错。然后点 “Advanced Options”选 “Search sequence”这是整个 exe4j 里最关键的一步。Search sequence 决定了 exe 启动时去哪里找 JRE。默认列表里有注册表、环境变量、当前目录等。我们要做的是点加号选 “Directory”然后把一个精简版 JRE 的路径填进去。这个 JRE 需要你提前准备好——可以从你开发机的 JDK 目录里拷一份jre文件夹出来然后用jlink或者第三方精简工具裁掉不需要的模块最终体积能压到 40MB 左右。填路径时用相对路径比如jre然后把那个精简 JRE 文件夹和 exe 放在同一层# 最终交付目录结构 dist/ ├── DataCollector.exe # exe4j 生成的 exe ├── jre/ # 精简 JRE和 exe 同级 │ ├── bin/ │ ├── lib/ │ └── ... └── lib/ # 如果依赖没打进 exe放这里逻辑说明search sequence 里 Directory 条目的路径是相对于 exe 所在目录的所以写jre就表示找 exe 旁边的 jre 文件夹。如果你把 JRE 放在C:\Program Files\Java这种绝对路径下换一台机器就失效了。参数上Directory 条目下面有个 “Preferred VM” 下拉框选 “Client” 还是 “Server” 取决于你的应用——桌面工具选 Client 启动快后台服务选 Server 吞吐高。配好之后一路 Next 到最后点 Finishexe 就生成了。4. 避坑与排查一闪而过、ClassNotFound 和 JRE 找不到的现场处理4.1 现象双击 exe 后黑框一闪而过什么都没留下原因这是最经典的问题。exe 启动后如果主线程抛了异常或者 main 方法执行完立刻返回控制台窗口会瞬间关闭你根本看不到报错信息。项目正文里给的方案是在 main 方法最后加Thread.sleep(5000000)这确实能让窗口停住但它是治标不治本——你只是把窗口留住了真正的异常还是没解决。解决分两步走。第一步临时加 sleep 让窗口停住看看到底报什么错。第二步根据报错定位。如果是ClassNotFoundException说明依赖没加全或者 Classpath 顺序不对如果是NoClassDefFoundError通常是某个类在编译时存在但运行时被 exe4j 漏掉了如果是UnsupportedClassVersionError就是 JRE 版本和编译版本不匹配。我一般会在 main 方法开头加一段日志重定向把System.err写到文件里这样即使窗口关了也能查public static void main(String[] args) { try { // 把标准错误重定向到文件方便排查一闪而过的问题 System.setErr(new PrintStream(new FileOutputStream(error.log, true))); } catch (FileNotFoundException e) { e.printStackTrace(); } // 你的业务代码 new MainFrame().setVisible(true); }参数说明FileOutputStream的第二个参数true表示追加模式多次启动不会覆盖之前的日志。error.log会生成在 exe 所在目录如果目录没有写权限比如放在 Program Files 下会抛 FileNotFoundException所以交付时建议让用户把整个 dist 文件夹放在 D 盘或桌面。4.2 现象exe 在开发机正常拷到目标机报 “Could not find the main class”原因开发机上你的 CLASSPATH 环境变量或者注册表里有 Java 路径exe4j 的 search sequence 可能优先命中了系统 JRE而不是你打包的精简 JRE。到了目标机系统 JRE 不存在search sequence 又没配好就找不到主类了。解决在 exe4j 的 search sequence 里把 “Directory” 条目拖到最上面确保它优先于 “Registry” 和 “Environment variable”。另外检查你填的 JRE 路径是否真的包含bin/java.exe和lib/rt.jarJava 8或lib/modulesJava 9。精简 JRE 时最容易漏掉lib/ext或者conf目录导致启动时缺配置。一个快速验证方法在目标机上用命令行运行jre\bin\java.exe -version如果能打印版本号说明 JRE 本身没问题。4.3 现象exe 体积异常大或者启动特别慢原因体积大通常是因为你把整个 JDK 目录当 JRE 打包了JDK 里的src.zip、demo、include这些都不需要。启动慢可能是因为 jar 被压缩了exe4j 每次启动都要解压到临时目录。解决精简 JRE 时只保留bin、lib、confJava 9三个目录bin里只留java.exe、javaw.exe、keytool.exe等必要文件lib里删掉src.zip、ct.sym、jconsole.jar等。如果启动慢在 exe4j 的 “Executable info” 那屏把 “Compress the JAR files” 取消勾选代价是 exe 体积会大 20% 左右但启动能快一倍。工控机场景我一般选不压缩因为现场操作工对启动速度很敏感。4.4 现象目标机杀毒软件报毒exe 被隔离原因exe4j 生成的 exe 是一个自解压启动器某些杀毒软件会把它识别为可疑的自解压程序尤其是你没加数字签名的时候。解决两个方向。一是给 exe 加一个简单的图标和版本信息exe4j 的 “Executable info” 屏可以填 Company name、Product name、Version让 exe 看起来更像正规软件二是在目标机上把 dist 目录加入杀毒软件白名单。如果交付量大可以考虑买一个代码签名证书但对内部工具来说成本太高白名单是更实际的做法。5. 进阶技巧用 jlink 定制 JRE 并验证 exe 在纯净环境下的可移植性5.1 用 jlink 生成最小 JRE 的完整命令如果你用的是 Java 9 及以上版本jlink比手动删文件靠谱得多。它可以根据模块依赖自动裁剪 JRE生成一个只有几十 MB 的运行时。前提是你的工程是模块化的或者至少你知道用到了哪些模块。一个典型的命令如下# 生成一个只包含 java.base 和 java.desktop 的最小 JRE jlink --module-path C:\Program Files\Java\jdk-17\jmods ^ --add-modules java.base,java.desktop,java.logging ^ --output dist\jre ^ --strip-debug ^ --no-header-files ^ --no-man-pages ^ --compress2逻辑说明--module-path指向 JDK 的jmods目录--add-modules列出你的应用实际用到的模块——串口通信用java.base和java.desktop通常够了如果用了日志框架再加java.logging。--strip-debug去掉调试信息--no-header-files和--no-man-pages去掉 C 头文件和手册页--compress2启用压缩。生成后的dist\jre直接放到 exe 旁边在 exe4j 的 search sequence 里指向它就行。参数上注意--compress2在 Java 17 里是合法值但 Java 21 改成了--compresszip-6这种格式版本不同写法不一样用之前先jlink --help确认一下。另外如果你的应用用了反射或者 JNIjlink 可能裁掉运行时才加载的模块导致ClassNotFoundException这时候要么把相关模块显式加进去要么用--bind-services让 jlink 自动分析。5.2 在虚拟机里验证可移植性的标准流程exe 生成之后别急着交付。我习惯在一个全新的 Windows 虚拟机里做一次完整验证这个虚拟机不装任何 JDK 和 JRE。步骤是把整个dist文件夹拷进去双击 exe看主界面能不能正常出来然后跑一遍核心功能——如果是串口工具就插一个 USB 转串口线看能不能打开端口收数据。这一步能暴露 90% 的依赖问题。验证时重点看三个地方第一exe 同级的jre文件夹是否被正确引用可以在 exe4j 的 search sequence 里把 “Directory” 设为唯一来源删掉其他条目强制它只用你打包的 JRE第二如果应用有配置文件确认配置文件路径是相对路径而不是绝对路径否则换机器就找不到第三检查error.log有没有生成如果有里面通常写着缺哪个类或者哪个 dll。5.3 一个我踩过的坑Thread.sleep 不是长久之计项目正文里提到用Thread.sleep(5000000)解决一闪而过我早期也这么干过后来发现两个问题一是 sleep 期间窗口虽然停住了但用户如果点了关闭按钮程序还是会退出异常信息依然可能丢二是如果异常发生在 sleep 之前比如类加载阶段sleep 根本执行不到。所以后来我改成在 main 方法最外层包一个 try-catch把异常写到文件同时弹一个JOptionPane显示错误摘要。这样即使窗口一闪而过用户也能看到弹窗你也能拿到日志。从那以后我每次打包 exe都会先在纯净虚拟机里跑一遍再在目标机器上跑一遍两遍都过了才交付。这个习惯帮我省掉了无数次“现场翻车再远程救火”的麻烦。希望帮到你。本文还有配套的精品资源点击获取