java fx 11+ 需手动配置 sdk 路径、模块声明及运行参数：下载匹配 jdk 版本的 javafx-sdk，配置 --module-path 和 --add-modules，module-info.java 中显式 requires 和 opens 相关模块，fxml 控制器包名须与 fx:controller 完全一致。
Java FX 11+ 不再捆绑 JDK，必须手动添加 javafx-sdk
Java 11 起，Oracle 官方 JDK 移除了 Java FX，IDEA 默认不识别 javafx.* 包。不是插件没装对，而是根本没提供类库——你写的 import javafx.application.Application; 会直接报红。
实操建议：
- 去 Gluon 官网 下载对应系统的
javafx-jdk-xx.x.x.zip（注意选和你项目 JDK 版本匹配的，比如用 JDK 17 就别下 JDK 21 的 SDK） - 解压后记住路径，例如：
/Users/you/javafx-sdk-17.0.2或C:\javafx-sdk-17.0.2 - 不要试图用 Maven 引入
org.openjfx:javafx-controls就跳过这步——模块化启动时，JVM 必须通过--module-path看到这些 JAR，否则运行时报java.lang.module.FindException: Module javafx.controls not found
模块声明（module-info.java）必须显式 requires 所有用到的 FX 模块
哪怕只用了 Button，也得写 requires javafx.controls;；如果还调了 WebView，还得加 requires javafx.web;。漏一个，编译不报错，但运行时 JVM 启动失败。
常见错误现象：
立即学习“Java免费学习笔记（深入）”；
- IDEA 显示 “Module not found” 但代码能编译 → 实际是
module-info.java里缺requires - 运行时报
Exception in thread "main" java.lang.IllegalAccessException: class javafx.graphics/com.sun.javafx.application.LauncherImpl (in module javafx.graphics) cannot access class your.Main (in module your.module.name)→ 缺opens your.package to javafx.graphics; -
javafx.fxml加载失败 → 必须requires javafx.fxml;且opens your.controller.package to javafx.fxml;
运行配置里必须填对 --module-path 和 --add-modules
IDEA 的 Run Configuration 不会自动拼 Java FX 模块路径，全靠手填。填错一个字符，就退回到“找不到主类”或“no main manifest attribute”这类误导性错误。
实操建议（以 macOS/Linux 为例，Windows 把分号换成分号）：
-
--module-path值填 SDK 的lib目录：/path/to/javafx-sdk-17.0.2/lib -
--add-modules填你实际用到的模块名，用逗号分隔：javafx.controls,javafx.fxml,javafx.web（别写成ALL-MODULE-PATH，它不解决 opens 缺失问题） - 确保
Main class是你模块里的启动类，且该类在module-info.java中已exports或opens给javafx.graphics - 如果用 Gradle，别只改
run.jvmArgs—— IDEA 运行配置优先级更高，它不读构建脚本
插件只是辅助，JavaFX Scene Builder 配合 FXML 才算真正落地
IDEA 自带的 Java FX 插件（JavaFX）只负责语法高亮、FXML 校验和右键预览，不解决模块路径或运行时依赖。真正降低开发成本的是把 Scene Builder 接进 IDEA。
使用场景：
- FXML 文件双击直接打开可视化编辑器，拖控件、设 ID、绑事件，比手写 XML 快得多
- 编辑完保存，IDEA 自动同步变更，无需刷新
- 注意：Scene Builder 本身要单独下载安装（Gluon 提供独立安装包），IDEA 设置里填的是它的可执行路径，比如
/Applications/SceneBuilder.app/Contents/MacOS/SceneBuilder - 别指望插件自动生成
module-info.java—— requires、opens、exports 全得自己写，IDEA 不会猜你要用WebView还是MediaView
最常被忽略的一点：FXML 控制器类的 package 必须和 FXML 文件里 fx:controller="your.package.YourController" 完全一致，且该 package 必须在 module-info.java 中 opens 给 javafx.fxml。少一个字母，加载就静默失败，控制台连日志都不打。
