IntelliJ无法识别JavaFX是什么原因？

JavaFX并非在所有JDK版本中都内置提供：仅Oracle JDK 8版本默认捆绑JavaFX组件，从Java 11开始，JavaFX正式从标准JDK中剥离，成为独立维护的OpenJFX开源项目，所有高于8版本的标准OpenJDK/Oracle JDK都不再内置JavaFX，因此IntelliJ IDEA无法自动识别JavaFX相关类属于正常情况，并非IDE故障。

对应报错截图：

方案1：通过构建工具自动引入依赖（推荐） #

使用Maven或Gradle管理项目依赖是最简便的方案，无需手动下载SDK、配置运行参数，IDEA会自动完成依赖识别关联。
以Maven为例，在项目pom.xml中添加和本地JDK大版本匹配的JavaFX依赖即可：

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>17.0.8</version> <!-- 可替换为和自身JDK版本适配的JavaFX版本 -->
    </dependency>
    <!-- 如果需要使用FXML，额外引入该依赖 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>17.0.8</version>
    </dependency>
</dependencies>

添加完成后刷新Maven依赖，即可正常导入使用JavaFX相关类。

方案2：手动配置本地JavaFX SDK #

如果项目未使用Maven/Gradle类构建工具，可以手动下载对应版本的OpenJFX SDK完成关联：

• 下载对应版本的OpenJFX SDK压缩包，解压到本地无中文、无空格的固定路径
• 按快捷键Ctrl+Alt+Shift+S打开项目结构设置
• 选择「Libraries」分类，点击+号，选中解压后OpenJFX SDK路径下的lib文件夹，将其添加为项目库
• 进入运行配置页面，在VM options栏添加如下启动参数（替换路径为你本地的JavaFX lib目录绝对路径）：

  --module-path C:/javafx-sdk-17.0.8/lib --add-modules javafx.controls,javafx.fxml
  

方案3：使用内置JavaFX的JDK发行版 #

如果不想单独配置JavaFX依赖，可以直接更换为自带JavaFX组件的JDK发行版，比如Azul Zulu JDK FX、BellSoft Liberica JDK Full版本，这类发行版默认集成了匹配版本的JavaFX。安装完成后在IDEA中将该JDK设置为项目SDK，无需额外配置即可直接识别JavaFX类。

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