无法运行JavaFX项目导出的Jar文件（LinkageError与UnsupportedClassVersionError）

核心原因 #

你在VSCode的launch.json中仅配置了运行阶段的--enable-preview参数，但导出Jar后，运行Jar的命令未包含该参数；同时需确保编译阶段也正确启用了预览特性，否则生成的class文件会标记为依赖预览特性，但运行时未开启支持。

解决步骤 #

1. 运行Jar时必须传递完整参数 #

直接执行java -jar MyApp.jar不会继承VSCode中的VM参数，需手动指定所有必要的JVM参数，且--enable-preview必须放在-jar之前（属于JVM级参数）：

java --enable-preview --module-path "C:/Program Files/Java/javafx-sdk-21.0.2/lib" --add-modules javafx.controls,javafx.fxml -jar MyApp.jar

2. 确保编译阶段启用预览特性 #

VSCode中手动编译时，需配置编译参数开启预览特性：

• 打开VSCode设置（快捷键Ctrl+,），搜索java.compiler.args，添加参数：

  --enable-preview
  

• 如果用命令行编译类文件，需加上该参数：

  javac --enable-preview -source 21 HelloFX.java
  

3. （可选）用jlink打包更便捷的可执行镜像 #

对于JavaFX项目，推荐使用jlink生成包含运行时环境的可执行镜像，避免每次运行手动传递参数：

1. 先编译类文件（确保带--enable-preview）
2. 执行jlink命令：

jlink --module-path "C:/Program Files/Java/javafx-sdk-21.0.2/lib";. --add-modules javafx.controls,javafx.fxml,your.module.name --output app-image --enable-preview

之后直接运行app-image/bin/java.exe -m your.module.name/HelloFX即可，无需额外参数。

内容的提问来源于stack exchange，提问作者dieterweireldt