macOS下Java应用无法获取右键打开/拖放文件的参数问题

关于open --args的含义 #

默认执行open myfile.txt -a myapp.app时，macOS的逻辑是让myapp.app去打开myfile.txt这个文件，系统会通过Application Kit的事件机制把文件信息传递给应用，而不是直接把文件路径作为命令行参数塞给main函数。

--args参数是强制改变这个行为：后面跟的所有内容会直接作为命令行参数传给应用的main()函数，系统不会再尝试去“打开”这些参数对应的文件，完全交给应用自己解析处理。这就是为什么加了--args后你能在args里拿到路径。

无需--args获取文件路径的方案 #

1. 利用universalJavaApplicationStub的环境变量 #

universalJavaApplicationStub会自动把拖放、右键打开的文件路径存入环境变量，你可以在Java代码里直接读取：

• System.getenv("APP_ARGS")：所有要打开的文件路径，用空格分隔（路径含空格时会自动转义）
• System.getenv("APP_FIRST_ARG")：第一个文件的路径

示例代码：

public static void main(String[] args) {
    String appArgs = System.getenv("APP_ARGS");
    if (appArgs != null && !appArgs.isEmpty()) {
        String[] files = appArgs.split(" ");
        // 处理文件路径
        for (String file : files) {
            System.out.println("要打开的文件：" + file);
        }
    }
}

2. 通过Java的桌面事件处理（更符合macOS应用规范） #

macOS GUI应用的文件打开请求是通过系统事件传递的，而非命令行参数，你可以用Java的java.awt.desktop API处理：

import java.awt.Desktop;
import java.awt.desktop.OpenFilesEvent;
import java.awt.desktop.OpenFilesHandler;
import java.io.File;

public class MyApp {
    public static void main(String[] args) {
        if (Desktop.isDesktopSupported()) {
            Desktop desktop = Desktop.getDesktop();
            desktop.setOpenFileHandler(new OpenFilesHandler() {
                @Override
                public void openFiles(OpenFilesEvent e) {
                    for (File file : e.getFiles()) {
                        System.out.println("要打开的文件：" + file.getAbsolutePath());
                        // 这里处理文件逻辑
                    }
                }
            });
        }
        // 启动你的应用逻辑
    }
}

如果用JavaFX，也可以通过Application的参数获取：

import javafx.application.Application;
import javafx.stage.Stage;
import java.util.List;

public class MyFxApp extends Application {
    @Override
    public void start(Stage primaryStage) {
        List<String> files = getParameters().getUnnamed();
        for (String file : files) {
            System.out.println("要打开的文件：" + file);
        }
        // 初始化UI
    }

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

3. 配置universalJavaApplicationStub传递参数到main args #

如果你希望直接在main的args里拿到文件路径，可以修改Info.plist，给universalJavaApplicationStub添加配置：
在CFBundleExecutable对应的universalJavaApplicationStub配置里，添加JAVA_APP_ARGS环境变量，设置为${APP_ARGS}，这样stub会把文件路径作为命令行参数传给Java的main函数。

修改后的Info.plist片段：

<key>EnvironmentVariables</key>
<dict>
    <key>JAVA_APP_ARGS</key>
    <string>${APP_ARGS}</string>
</dict>

这样配置后，拖放或右键打开文件时，文件路径就会直接出现在main函数的args数组里，和Windows下的行为一致。

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