如何检测JavaFX程序被关联文件打开时对应的文件路径

方案1：读取程序启动入参 #

这是最通用的实现路径，系统打开关联文件时，会自动把文件的绝对路径作为启动参数传递给应用，直接在主类入口处读取即可：

• 如果你用Java标准主类入口（带main方法），直接遍历main方法的String[] args参数，第一个非空参数通常就是关联文件的完整路径
• 如果你用JavaFX原生Application类生命周期入口，调用getParameters().getRaw()方法即可拿到所有启动参数，第一个有效参数即为目标文件路径
  示例代码：

public class MyApp extends Application {
    @Override
    public void start(Stage primaryStage) {
        List<String> params = getParameters().getRaw();
        if (!params.isEmpty()) {
            String targetFilePath = params.get(0);
            // 此处执行文件读取逻辑
        }
        // 剩余应用启动逻辑
    }

    public static void main(String[] args) {
        launch(args);
    }
}

注意：安装包的文件关联配置必须预留参数占位符，比如Windows下注册表关联命令要写成"你的程序路径" "%1"，macOS下Info.plist要正确声明文档类型，否则系统不会传递文件路径参数

方案2：单实例场景补充处理 #

如果你的应用做了单实例限制，用户双击第二个关联文件时不会启动新进程，需要额外做进程间通信传递路径：

• 新进程启动时首先检测是否有已运行的实例，存在则将文件路径通过socket、共享内存或者平台原生API发送给已运行实例，随后新进程直接退出
• 已运行的实例监听到传入路径后，直接触发对应的文件打开逻辑即可

方案3：平台特定原生API适配 #

如果上述方法无法拿到路径，可以对应运行平台做原生适配：

• Windows下可以调用GetCommandLineW原生API获取完整启动命令行，自行解析出文件路径
• macOS下可以通过OpenFilesEvent或者JavaFX自带的setOpenFileHandler回调获取路径，该方法对已经运行的应用触发关联文件打开的场景也生效
  示例macOS回调代码：

// 该代码需放在start方法执行前调用
Application.getApplication().setOpenFileHandler(event -> {
    List<File> files = event.getFiles();
    if (!files.isEmpty()) {
        String filePath = files.get(0).getAbsolutePath();
        // 处理目标文件
    }
});

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