IntelliJ打包JAR在IDE内运行正常，独立运行无法加载资源如何解决

该问题90%以上是资源加载方式不符合JAR包类路径资源读取规则导致的：

• IntelliJ运行时的工作目录默认是项目根目录，如果你用文件系统API（如File、FileInputStream）读取项目内的资源文件，此时可以正常读到本地磁盘上的资源
• 打包成JAR后，资源文件是压缩在JAR包内部的，不属于磁盘独立文件，文件系统API无法直接读取，就会出现资源加载失败、界面空白的问题
• 少部分情况是资源路径大小写不匹配、自定义字体未正确注册导致的

• 第一步：替换所有资源加载API
  废弃所有基于文件系统的资源读取写法，统一使用类加载器读取类路径资源，示例写法：

  // 读取图片示例
  BufferedImage gameBg = ImageIO.read(YourMainClass.class.getResource("/assets/images/bg.png"));
  // 读取自定义字体示例
  InputStream fontStream = YourMainClass.class.getResourceAsStream("/assets/fonts/custom.ttf");
  Font customFont = Font.createFont(Font.TRUETYPE_FONT, fontStream).deriveFont(24f);
  // 注册字体到Swing环境
  GraphicsEnvironment.getLocalGraphicsEnvironment().registerFont(customFont);
  

  注意：路径开头的/代表从JAR包的类路径根目录开始查找，没有/则是从当前类的包目录下查找，需要和资源实际存放路径匹配。

• 第二步：校验JAR内资源路径
  执行jar tf 你的游戏包名.jar命令列出JAR包内的所有文件，确认资源的实际存放路径和代码中写的路径完全一致，尤其注意大小写，Windows环境下路径大小写不敏感，IntelliJ运行时不报错，但独立运行时可能触发大小写匹配失败。

• 第三步：命令行启动查看报错
  不要双击运行JAR，改用命令行执行java -jar 你的游戏包名.jar启动，在资源加载代码中补充完整的异常捕获打印逻辑，可以直接看到具体哪个资源加载失败、抛出的异常信息，快速定位问题点。

• 第四步：排查硬编码工作目录逻辑
  检查是否有代码使用System.getProperty("user.dir")拼接资源路径，该参数获取的是程序启动时的工作目录，IntelliJ运行时是项目根目录，双击运行JAR时是JAR文件所在目录，路径不匹配会导致资源读取失败。

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