使用NetBeans与Apache Ant构建可双击运行JAR文件的问题

你的问题核心是：双击JAR时，系统默认的java -jar命令不会自动带上JavaFX所需的--module-path和--add-modules参数，导致找不到FX依赖。下面给你几个实用方案，按从简单到彻底排序：

方案1：写个批处理文件（最快上手） #

直接把你CMD里的命令存成批处理，双击批处理就能启动程序，新手零成本：

1. 在JAR文件同目录下新建一个文本文件
2. 把下面内容复制进去，注意把--module-path里的路径改成你自己的FX SDK路径（如果JAR和FX SDK相对路径固定，也可以改成相对路径，方便移动）：

@echo off
java --module-path "F:\Documentos\Desarrollos\NetBeansProjects\BackOffice\lib\openjfx-17.0.10_windows-x64_bin-sdk\javafx-sdk-17.0.10\lib" --add-modules javafx.controls,javafx.fxml -jar "BackOffice.jar"
pause

3. 把文本文件后缀改成.bat（比如启动BackOffice.bat），以后双击这个bat就行。加pause是为了如果程序启动出错，窗口不会直接关掉，能看到报错信息。

方案2：用jpackage打包成EXE（最彻底，像原生软件） #

这个方法会把你的程序、JavaFX依赖、甚至JDK运行时打包成一个独立的EXE文件，用户双击完全不用管Java环境，适合分发：
因为你用Ant构建，需要在Ant脚本里加两个exec任务，分别调用jlink和jpackage命令：

1. 先确保你的JDK是Java 11及以上（JavaFX 17推荐用JDK 17），并且JDK的bin目录在系统PATH里（或者写全路径）
2. 在Ant的build.xml里添加任务：

<!-- 第一步：用jlink生成包含JavaFX模块的自定义JRE -->
<target name="create-runtime">
    <exec executable="jlink">
        <arg line="--module-path &quot;${fx.sdk.lib.dir};${jdk.home}/jmods&quot;" />
        <arg line="--add-modules javafx.controls,javafx.fxml,你的主模块名" />
        <arg line="--output runtime" />
        <arg line="--strip-debug --compress=2 --no-header-files --no-man-pages" />
    </exec>
</target>

<!-- 第二步：用jpackage打包成EXE -->
<target name="package-exe" depends="create-runtime">
    <exec executable="jpackage">
        <arg line="--name BackOffice" />
        <arg line="--input 你的JAR所在目录" />
        <arg line="--main-jar BackOffice.jar" />
        <arg line="--runtime-image runtime" />
        <arg line="--type exe" />
        <arg line="--win-console" /> <!-- 可选，加这个如果程序有控制台输出能看到，不加就是纯窗口程序 -->
    </exec>
</target>

替换上面的${fx.sdk.lib.dir}为你的JavaFX SDK的lib目录路径，你的主模块名是你module-info.java里的模块名（如果没写module-info，那可能是自动模块，这时候--add-modules只写javafx.controls,javafx.fxml就行），你的JAR所在目录是BackOffice.jar的路径。
3. 运行Ant的package-exe任务，生成的EXE会在当前目录下的BackOffice文件夹里，直接双击就能运行。

方案3：修改MANIFEST.MF（不推荐，有局限性） #

JavaFX模块化下，没法在MANIFEST里直接指定模块路径，不过如果你把JavaFX的所有JAR（包括javafx-controls.jar、javafx-fxml.jar以及它们的依赖JAR）都放到你的程序lib目录，并且把它们加到classpath里，同时在MANIFEST里指定主类，可能可以运行，但这种方式不遵循模块化规范，而且FX的原生库（.dll文件）还是可能找不到，所以只适合临时测试：
在Ant的jar任务里配置MANIFEST：

<jar destfile="BackOffice.jar" basedir="编译后的class目录">
    <manifest>
        <attribute name="Main-Class" value="你的主类全路径" />
        <attribute name="Class-Path" value="lib/javafx-controls.jar lib/javafx-fxml.jar lib/javafx-base.jar lib/javafx-graphics.jar ..." />
    </manifest>
    <!-- 把所有依赖JAR都复制到JAR同目录的lib文件夹里 -->
    <fileset dir="lib" includes="*.jar" />
</jar>

但注意：这种方法可能还是会因为原生库找不到而报错，所以不如前两个方案靠谱。

方案4：修改全局JDK（不推荐，影响全局环境） #

把JavaFX的模块复制到你的JDK的jmods目录里，这样系统默认的java -jar就能找到FX模块，但这样会修改你的全局JDK，换机器或者换JDK就失效了，不建议用。

内容的提问来源于stack exchange，提问作者David Carmona Arrabal