Mac环境下使用Eclipse运行JavaFX报错：未找到javafx.controls模块

1. 校验模块路径的有效性 #

• 执行终端命令ls /Users/本地实际用户名/Desktop/javafx-sdk-11.0.2_3/lib，确认输出列表中包含javafx.controls.jar、javafx.fxml.jar实体文件
• 若本地Mac用户目录包含空格，必须为--module-path对应的路径添加双引号包裹，避免路径被截断识别。正确格式示例：--module-path "/Users/带空格的用户名/Desktop/javafx-sdk-11.0.2_3/lib" --add-modules javafx.controls,javafx.fxml
• 排查是否未替换教程占位符，误将myname作为实际用户名写入配置，未匹配本地电脑的真实用户目录路径

2. 解决JavaFX双加载机制的冲突问题 #

• 采用模块化VM参数加载JavaFX时，必须移除项目Build Path中所有手动导入的JavaFX相关jar包
• 模块化类加载与传统类路径加载为两套独立运行机制，同时混用会导致类加载优先级混乱，触发模块找不到的异常。两种加载方案二选一即可：
  • 保留VM参数的模块化配置，删除项目lib目录下所有导入的JavaFX jar，仅靠VM参数指定的SDK路径完成模块加载
  • 移除所有JavaFX相关VM参数，直接将项目lib下的JavaFX jar添加到Build Path，走传统类路径模式运行

3. 核对运行配置的参数实际生效范围 #

• 不要仅在项目全局属性页修改VM参数，需直接打开对应主类的专属运行配置（右键主类 -> Run As -> Run Configurations）
• 切换到Arguments标签页，在VM arguments输入框内重新粘贴完整的模块参数，确认无多余换行、无字符截断、无参数拼接错误
• 切换到JRE标签页，确认运行时选择的是JDK 11及以上版本。JavaFX 11基于模块系统设计，不兼容JDK 1.8的类加载逻辑，会直接触发模块查找失败异常

4. 排除SDK文件损坏或路径指向偏差问题 #

• 重新解压官方下载的JavaFX 11.0.2 SDK压缩包，避免在压缩包预览界面直接配置lib目录路径，防止实际指向的路径下无实体jar文件
• 确认SDK版本与系统架构匹配，Mac Intel芯片与Apple芯片需选择对应架构的SDK版本，避免模块文件无法被正确识别

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