无法运行JavaFX应用求协助：主类初始化失败及启动异常

一、先处理「IllegalArgumentException: 0 > -2」异常 #

这个错误是JavaFX布局组件的尺寸参数非法导致的，核心是代码里出现了负数尺寸或约束设置：

• 检查start()方法中的布局代码：排查是否有setMinWidth(-2)、setPrefHeight(-1)这类设置负数尺寸的语句
• 若使用FXML文件，检查控件属性里的prefWidth、minHeight等字段是否被设为负数
• 检查GridPane、VBox等布局的约束参数，比如setColumnSpan、setHgap是否传入了负数

二、解决「Unable to initialize main class TipCalculator」问题 #

该错误多因JavaFX模块路径配置错误，以下是VS Code中的清晰配置流程：

1. 准备JavaFX SDK #

下载对应Java版本的JavaFX SDK，解压到本地固定路径（例如D:\javafx-sdk-21）

2. 配置项目依赖 #

打开项目的.vscode文件夹，创建或编辑settings.json，添加依赖配置：

{
    "java.project.referencedLibraries": [
        "你的JavaFXSDK路径/lib/*.jar"
    ]
}

将你的JavaFXSDK路径替换为实际解压路径，比如D:/javafx-sdk-21

3. 配置运行参数 #

编辑.vscode文件夹下的launch.json，在configurations节点中添加VM参数：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Launch TipCalculator",
            "request": "launch",
            "mainClass": "TipCalculator", // 若主类带包名需写全，比如com.example.TipCalculator
            "vmArgs": "--module-path 你的JavaFXSDK路径/lib --add-modules javafx.controls,javafx.fxml"
        }
    ]
}

若未使用FXML，可将javafx.fxml从--add-modules参数中移除

4. 模块化项目额外配置（若有module-info.java） #

在module-info.java中添加模块依赖声明：

module TipCalculator {
    requires javafx.controls;
    requires javafx.fxml; // 未使用FXML可删除该行
    opens 你的主类包名 to javafx.fxml; // 例如opens com.example to javafx.fxml;
    exports 你的主类包名;
}

三、命令行运行的正确指令 #

切换到编译后的class文件所在目录，执行以下命令：

java --module-path 你的JavaFXSDK路径/lib --add-modules javafx.controls,javafx.fxml 主类全限定名

主类全限定名需包含包名（如果有），比如com.example.TipCalculator

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