Mac系统如何实现双击直接打开jar文件 无需通过终端运行

终端执行java -jar xxx.jar能正常启动、双击失效，本质上是双击启动的流程和手动执行指令的流程不一致，常见触发场景分四类：

• 系统层面没有给.jar后缀绑定正确的Java启动程序，要么绑定成了解压软件、其他不兼容版本的Java，要么启动参数缺失-jar，导致系统拿到jar包无法正确调起Java进程
• jar包的清单文件META-INF/MANIFEST.MF没有配置正确的主类入口，手动在终端启动时如果是直接指定主类运行的，自然不受清单配置影响，但双击启动时Java依赖清单里的Main-Class参数找程序入口，找不到就会直接静默闪退
• 程序依赖相对路径读取外部资源/配置文件，双击启动时系统给Java进程分配的工作目录不是jar包所在目录，导致程序读不到文件直接崩溃，而终端启动时已经切到了jar所在目录，路径匹配所以能正常运行
• 系统安全策略拦截了未签名jar包的静默启动，这类拦截大多没有弹窗提示，只会直接结束进程

按顺序排查操作即可：

• 先确认jar包本身的启动配置合规
  切到jar包所在目录，执行指令java -jar 你的jar文件名.jar，如果这步都启动失败，先回去修正打包配置：

  打包时必须保证生成的jar包内META-INF/MANIFEST.MF文件存在合法的主类配置，格式为Main-Class: 程序主类的全限定类名，注意冒号后必须留1个半角空格，文件末尾要保留一个空行。如果用Maven/Gradle等构建工具打包，直接配置对应jar插件的mainClass参数即可，不要手动改编译后的jar包文件，容易损坏清单格式。

• 修正系统的jar文件默认打开关联
  • Windows系统：右键任意jar文件，选择「打开方式」→「选择其他应用」，找到当前使用的JDK/JRE安装路径下bin目录中的javaw.exe（不要选同目录下的java.exe，这个是带控制台窗口的启动程序，GUI程序用javaw启动不会额外弹黑框），勾选「始终使用此应用打开.jar文件」保存。如果设置完还是无法启动，直接打开注册表编辑器，定位到路径计算机\HKEY_CLASSES_ROOT\jarfile\shell\open\command，把默认值修改为"javaw.exe的绝对路径" -jar "%1" %*，注意路径外必须加半角双引号，-jar参数不能遗漏。
  • macOS系统：右键jar文件选择「显示简介」，在「打开方式」下拉菜单中选择对应JDK版本附带的JavaLauncher.app，点击「全部更改」将配置同步到所有jar文件。如果是系统安全隔离拦截，在终端执行sudo xattr -d com.apple.quarantine 你的jar文件绝对路径移除隔离标记即可。
• 路径问题修复
  如果以上配置都正常，双击还是闪退，检查代码里的文件读取逻辑：不要用new File("config/xxx.properties")这种相对路径写法，双击启动时工作目录不固定，大概率读不到文件。统一改成用类加载器读取classpath内的资源，或者在程序启动时动态获取jar包所在路径作为根目录拼接文件路径。

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