JavaFX应用启动报错求助：模块描述符无效（未命名包不允许）

这个问题我之前也碰到过，核心原因是Java模块系统不允许无名包（没有package声明的类）存在于模块化项目中，你的报错信息已经明确指出了这点：FirstWindow.class found in top-level directory (unnamed package not allowed in module)。下面给你两种解决方案，根据你的需求选择：

方案一：继续使用模块化项目（推荐长期项目） #

如果你的项目保留了module-info.java（模块化项目的标志），按以下步骤调整：

1. 给你的类添加包声明：在FirstWindow.java的最顶部加上包名，比如：

   package com.example; // 自定义包名，只要不是空的就行
   
   import javafx.application.Application;
   import javafx.scene.Scene;
   import javafx.scene.control.Button;
   import javafx.stage.Stage;
   
   public class FirstWindow extends Application {
       @Override
       public void start(Stage primaryStage) {
           Scene scene = new Scene(new Button("OK"),300,300);
           primaryStage.setScene(scene);
           primaryStage.setTitle("First Window!!");
           primaryStage.show();
       }
   
       public static void main (String[] args){
           Application.launch(args);
       }
   }
   

2. 更新module-info.java：添加exports语句让JavaFX能访问你的类，示例：

   module HelloWorldFX {
       requires javafx.controls; // 引入JavaFX控件模块
       exports com.example; // 导出你刚才声明的包
   }
   

3. 重新运行项目，应该就能正常弹出窗口了。

方案二：切换为非模块化项目（适合快速测试） #

如果你只是想快速运行代码，不想搞模块化，可以这样做：

1. 删除项目中的module-info.java文件，这样项目就变成非模块化的了，Java允许非模块化项目使用无名包。
2. 检查运行配置的VM参数：确保你在运行配置里正确指定了JavaFX的路径和需要的模块，比如在IDEA的VM选项里填写：

   --module-path "你的JavaFX SDK路径/lib" --add-modules javafx.controls
   

   把你的JavaFX SDK路径替换成你实际下载的JavaFX文件夹路径，比如C:\javafx-sdk-17.0.9\lib。

额外检查点 #

• 确保你的JDK版本和JavaFX SDK版本一致（比如JDK17对应JavaFX17，版本不匹配也可能导致奇怪的错误）
• 如果是用命令行运行，要确保javac和java命令都正确带上了JavaFX的参数

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