本文旨在解决javafx开发中常见的`application`类找不到符号的编译错误。该问题通常源于jdk环境未包含Javafx运行时或项目配置不当。教程将详细阐述错误原因，并提供两种主要解决方案：使用集成javafx的jdk，或通过模块化方式将openjfx作为依赖引入项目，并辅以代码示例和配置指导，确保开发者能够顺利启动javafx应用程序。
理解JavaFX application 类找不到符号错误
在JavaFX应用程序开发中，如果遇到类似java.lang.RuntimeException: Uncompilable code – cannot find symbol symbol: class Application的错误，这通常意味着Java编译器无法在当前构建路径中找到javafx.application.Application类。尽管您的代码中可能正确地使用了import javafx.application.Application;，但如果底层的JDK环境或项目配置未能提供JavaFX运行时库，编译器就无法解析这个符号。
以下是可能导致此错误的典型代码结构：
import javafx.application.Application; import javafx.scene.Group; import javafx.scene.Scene; import javafx.scene.shape.Circle; import javafx.stage.Stage; public class NewClass extends Application { @Override public void start(Stage stage) { Circle circ = new Circle(40, 40, 30); Group root = new Group(circ); Scene scene = new Scene(root, 400, 300); stage.setTitle("My JavaFX Application"); stage.setScene(scene); stage.show(); } public static void main(String[] args) { launch(args); // 启动JavaFX应用程序 } }
当您尝试编译或运行上述代码时，如果环境未正确配置JavaFX，就会抛出ExceptionInInitializerError，其根本原因通常是Uncompilable code – cannot find symbol。
错误根源分析
自Java 11起，oracle JDK不再默认捆绑JavaFX模块。这意味着，如果您使用的是标准的OpenJDK发行版（如Adoptium OpenJDK、Oracle OpenJDK等）或较新的Oracle JDK版本，并且没有额外配置JavaFX库，那么编译器和jvm将无法找到JavaFX相关的类。
立即学习“Java免费学习笔记（深入）”；
解决此问题的核心在于确保JavaFX运行时库（OpenJFX SDK）能够被您的项目识别和使用。主要有两种策略：
- 使用包含JavaFX的JDK发行版。
- 将OpenJFX作为外部模块或依赖项添加到项目中。
解决方案
方案一：使用集成JavaFX的JDK发行版
某些JDK发行版（如Gluon提供的OpenJFX SDK捆绑的JDK，或一些旧版本的Oracle JDK 8）会预先集成JavaFX。如果您倾向于这种方式，可以：
- 下载并安装带有JavaFX的JDK。 访问OpenJFX官方网站 (openjfx.io) 或Gluon网站，查找包含JavaFX的JDK发行版。
- 配置您的IDE使用此JDK。 在IntelliJ idea、eclipse或其他IDE中，将项目的JDK指向您安装的这个集成JavaFX的JDK。
优点： 配置相对简单，对于初学者可能更容易上手。 缺点： 不够灵活，可能限制您选择特定的JDK版本。
方案二：将OpenJFX作为外部模块/依赖引入项目（推荐）
这是目前推荐的、更灵活的JavaFX开发方式，尤其适用于现代Java版本。它允许您使用任何标准的JDK，然后独立地引入JavaFX库。
步骤 1: 下载OpenJFX SDK
访问OpenJFX官方网站 (openjfx.io/openjfx-docs/)，下载与您的JDK版本兼容的OpenJFX SDK。下载后，解压到一个您方便访问的目录，例如C:javafx-sdk-17 (windows) 或 /opt/javafx-sdk-17 (linux/macOS)。这个目录包含了JavaFX的lib文件夹，其中有所有必要的JAR文件。
步骤 2: 配置您的开发环境
根据您使用的开发工具，配置方式有所不同。
对于命令行编译和运行
如果您直接使用javac和java命令，需要指定JavaFX模块的路径。
-
编译：
javac --module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml YourJavaFXApp.java
请将/path/to/javafx-sdk/lib替换为您的OpenJFX SDK lib目录的实际路径，YourJavaFXApp.java替换为您的主JavaFX文件。–add-modules后面列出您的应用实际使用的JavaFX模块，javafx.controls和javafx.fxml是两个常用模块。
-
运行：
java --module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml YourJavaFXApp
注意：如果您的应用程序使用了main方法来调用launch(args)，您可能还需要添加–add-modules javafx.graphics。
对于集成开发环境（IDE）
大多数开发者会使用IDE进行JavaFX开发。以下是主流IDE的配置概要：
- 创建新项目： 选择“New Project”，在左侧选择“JavaFX”。确保选择正确的JDK。
- 配置JavaFX SDK： 如果是第一次创建JavaFX项目，IDEA会提示您配置JavaFX SDK。点击“+”号，选择“JavaFX SDK”，然后导航到您下载并解压的OpenJFX SDK根目录（例如C:javafx-sdk-17）。IDEA会自动找到lib文件夹。
- 现有项目： 对于现有项目，进入“File” -> “Project Structure” -> “Libraries”。点击“+”号，选择“Java”，然后导航到OpenJFX SDK的lib目录，选择所有JAR文件并添加。
- VM Options： 在运行配置中，通常需要添加VM Options。进入“Run” -> “Edit Configurations…”，找到您的应用程序配置，在“VM options”字段中添加：
--module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml,javafx.graphics
再次提醒，/path/to/javafx-sdk/lib是您的OpenJFX SDK lib目录的实际路径。
b. Eclipse
- 下载JavaFX SDK： 同上。
- 创建或配置项目：
- 新建项目： Eclipse默认没有JavaFX项目模板，您可以创建一个普通的Java项目。
- 添加库： 右键点击您的项目 -> “Properties” -> “Java Build Path” -> “Libraries”选项卡。点击“Add External JARs…”，导航到OpenJFX SDK的lib目录，选择所有JAR文件并添加。
- 运行配置： 进入“Run” -> “Run Configurations…”，选择您的Java应用程序配置。在“Arguments”选项卡下的“VM arguments”字段中添加：
--module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml,javafx.graphics
对于大型或模块化项目，推荐使用Maven或Gradle来管理JavaFX依赖。这可以自动化下载和配置过程。
Maven pom.xml 示例：
<project> <!-- ... 其他配置 ... --> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <javafx.version>17.0.2</javafx.version> <!-- 替换为您的JavaFX版本 --> </properties> <dependencies> <dependency> <groupId>org.openjfx</groupId> <artifactId>javafx-controls</artifactId> <version>${javafx.version}</version> </dependency> <dependency> <groupId>org.openjfx</groupId> <artifactId>javafx-fxml</artifactId> <version>${javafx.version}</version> </dependency> <!-- 根据需要添加其他JavaFX模块，例如 javafx-graphics, javafx-media 等 --> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>${maven.compiler.source}</source> <target>${maven.compiler.target}</target> </configuration> </plugin> <plugin> <groupId>org.openjfx</groupId> <artifactId>javafx-maven-plugin</artifactId> <version>${javafx.version}</version> <executions> <execution> <!-- Default configuration for running with: mvn clean javafx:run --> <id>default-cli</id> <configuration> <mainClass>com.yourcompany.YourJavaFXApp</mainClass> <!-- 替换为您的主类 --> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
Gradle build.gradle 示例：
plugins { id 'java' id 'application' id 'org.openjfx.javafxplugin' version '0.0.10' // 替换为最新版本 } group 'com.yourcompany' version '1.0-SNAPSHOT' repositories { mavenCentral() } javafx { version = "17.0.2" // 替换为您的JavaFX版本 modules = [ 'javafx.controls', 'javafx.fxml' ] // 根据需要添加其他模块 } application { mainClass = 'com.yourcompany.YourJavaFXApp' // 替换为您的主类 }
注意事项与总结
- 版本兼容性： 确保您下载的OpenJFX SDK版本与您使用的JDK版本兼容。OpenJFX官方文档会提供详细的兼容性矩阵。
- 模块化： JavaFX是模块化的。在–add-modules参数或构建工具配置中，只添加您应用程序实际使用的JavaFX模块。javafx.controls和javafx.fxml是大多数GUI应用的基础，javafx.graphics通常由javafx.controls等隐式依赖，但有时也需要明确指定。
- IDE配置： 不同的IDE有不同的项目设置方式。务必仔细查阅您所用IDE的官方文档或相关教程，确保JavaFX SDK被正确添加为库或模块依赖。
- Maven/Gradle： 使用构建工具是管理复杂项目和依赖的最佳实践。它们可以大大简化JavaFX项目的设置和构建过程。
通过以上任一方案的正确配置，您将能够解决Application类找不到符号的错误，并顺利编译和运行您的JavaFX应用程序。理解问题的根源（JDK与JavaFX分离）是解决问题的关键，而选择合适的配置方式则能让您的开发流程更加顺畅。