从Github克隆Java GUI项目后设置JButton图标出现Null异常

这个问题我做Swing项目时也碰到过，核心原因是资源文件没有被正确打包到编译后的classpath中，或者资源路径的写法、项目配置存在问题。咱们一步步来排查和解决：

1. 确认资源文件的存放与项目配置 #

首先要保证图标文件在编译时能被自动复制到classpath目录：

• 如果是Maven/Gradle项目，把图标放到src/main/resources目录下（如果需要分类，可创建子文件夹比如icons，把图标放到src/main/resources/icons）。
• 如果是普通Java项目（比如IDEA创建的），右键图标所在的文件夹，选择「Mark Directory as」→「Resources Root」，这样IDE编译时会自动把这些文件复制到输出目录（比如out/production/classes）。

2. 检查资源路径的写法 #

你当前使用的getClass().getResource("/DeleteIconHover.png")是从classpath根目录开始的绝对路径，这要求编译后的classpath根目录下必须存在DeleteIconHover.png文件：

• 如果图标放在resources/icons子文件夹下，路径要改成/icons/DeleteIconHover.png。
• 注意文件名大小写！Windows系统不区分大小写，但Linux/macOS是严格区分的，克隆到不同系统后，大小写不匹配就会导致找不到文件。

3. 验证编译后的文件结构 #

克隆项目并编译后，去输出目录（比如Maven的target/classes，IDEA的out/production/classes）里检查是否有你的图标文件：

• 如果没有，说明资源文件没被正确复制：
  • Maven项目：检查pom.xml里的资源配置，确保包含图片文件：

    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.png</include>
                </includes>
            </resource>
        </resources>
    </build>
    

  • 普通Java项目：打开「Project Structure」→「Modules」→「Sources」，确认资源文件夹的类型是「Resources」，且输出路径和源代码一致。

4. 更可靠的资源获取方式 #

有时候getClass().getResource()会因为类的加载上下文出问题，换成ClassLoader来获取资源试试：

// 两种可行方式
DeleteBtn.setIcon(new javax.swing.ImageIcon(ClassLoader.getSystemResource("DeleteIconHover.png")));
// 或者
DeleteBtn.setIcon(new javax.swing.ImageIcon(getClass().getClassLoader().getResource("DeleteIconHover.png")));

关于绝对路径的疑问 #

你提到通过文件引用的绝对路径存在但exists()返回false，且路径不含src目录——这是因为程序运行时读取的是编译后的输出目录（比如target/classes），而不是src目录里的源文件。src里的文件是开发时用的，运行时程序会从classpath（也就是编译后的输出目录）加载资源，所以直接用文件路径访问src里的文件是无效的，必须通过classpath的方式获取。

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