Mac OS12下Eclipse导出的Java可运行Jar文件无法加载图片资源

核心原因 #

ClassLoader.getSystemResource()是从**类路径（classpath）**加载资源，你在Eclipse的Linked Resources里添加文件夹，只是让IDE能看到文件，但这些文件并没有被打包到Jar里，也没加入到类路径中，所以运行Jar时找不到。

具体解决步骤 #

1. 把图片文件夹加入项目Build Path #

Linked Resources只是Eclipse的项目路径映射，必须将图片文件夹设为Source Folder，才能让Eclipse编译时把内容复制到类路径，导出Jar时自动包含：

• 右键项目里的图片文件夹（或Linked Folder）→ Build Path → Add to Build Path
• 验证：打开项目Properties → Java Build Path → Source标签，确认图片文件夹在列表中。此时Eclipse会把文件夹内容编译输出到bin目录，导出Jar时会自动打包这些资源。

2. 检查Jar包是否包含图片资源 #

导出Jar后，用终端命令查看Jar内的文件结构，确认Images文件夹和对应GIF文件存在：

jar tf FileName.jar

如果输出里没有Images/InverseLineSelectTool.GIF这类路径，说明导出配置有问题，调整导出设置：

• 右键项目 → Export → Runnable JAR File（普通Jar选JAR File）
• 在导出向导中，确保Select the resources to export里勾选了图片文件夹（或直接勾选整个项目）
• 重点确认资源文件被包含，Library handling选项可根据需求选择（比如"Package required libraries into generated JAR"）

3. 修正路径大小写问题 #

MacOS默认文件系统不区分大小写，但Jar内的路径是严格区分大小写的。检查代码里的路径字符串（比如"Images/InverseLineSelectTool.GIF"）和实际文件名的大小写完全一致，包括文件夹名Images和文件名的大小写。

4. 更换更可靠的资源加载方式 #

系统类加载器的上下文在现代Java版本中可能存在限制，建议改用当前类的类加载器加载资源，替代ClassLoader.getSystemResource()：

// 替换成当前代码所在的类名，比如ToolImages
public static Image lineSelectedToolImage = Toolkit.getDefaultToolkit().getImage(
    ToolImages.class.getClassLoader().getResource("Images/InverseLineSelectTool.GIF")
);

或者用getResourceAsStream方式，避免路径解析问题：

public static Image lineSelectedToolImage = Toolkit.getDefaultToolkit().createImage(
    ToolImages.class.getClassLoader().getResourceAsStream("Images/InverseLineSelectTool.GIF")
);

5. 本地测试验证 #

• 先在Eclipse中运行项目，确认图片能正常显示，排除开发环境路径问题
• 导出Jar后，在终端用java -jar FileName.jar运行，观察报错是否消失

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