Java图片无法添加至面板求助：JLabel/JFrame实践问题

问题原因 #

直接使用new ImageIcon("key2.png")时，JVM会从当前工作目录加载图片。在VS Code中运行Java程序时，默认工作目录是项目根目录，而非src文件夹，所以找不到放在src里的图片文件。

解决方案 #

1. 调整图片位置（简单直接） #

将key2.png从src文件夹移到项目根目录（和src同级的位置），原代码无需修改即可加载图片。

2. 使用类加载器加载类路径资源（推荐，适配打包场景） #

src下的文件属于类路径资源，用类加载器可以准确获取资源路径，即使后续打包成Jar文件也能正常加载：
修改图片加载代码为：

ImageIcon icon = new ImageIcon(Main.class.getResource("key2.png"));

• 如果图片放在src的子目录（比如src/images/key2.png），路径要写成"/images/key2.png"（开头加斜杠表示从类路径根目录开始查找）。

3. 基础检查 #

• 确认图片文件没有损坏，能正常打开；
• 文件名拼写完全一致（包括大小写，Linux/macOS系统对文件名大小写敏感）。

优化建议 #

尽量避免使用setLayout(null)，Swing的布局管理器（如FlowLayout、BorderLayout等）能自动处理组件的大小和位置，手动设置bounds容易导致组件显示异常。另外可以添加代码调整文本与图片的排版：

label.setVerticalTextPosition(JLabel.BOTTOM); // 文本在图片下方
label.setHorizontalTextPosition(JLabel.CENTER); // 文本水平居中
label.setIconTextGap(5); // 文本与图片的间距

修改后的完整代码 #

import javax.swing.ImageIcon;
import javax.swing.JFrame;
import java.awt.Color;
import javax.swing.JLabel;
import javax.swing.JPanel;

class Main {
  public static void main(String[] args) {
    // 使用类加载器加载src目录下的图片
    ImageIcon icon = new ImageIcon(Main.class.getResource("key2.png"));

    JLabel label = new JLabel();
    label.setText("Hello");
    label.setIcon(icon);
    // 调整文本与图片的位置
    label.setVerticalTextPosition(JLabel.BOTTOM);
    label.setHorizontalTextPosition(JLabel.CENTER);

    JPanel redPanel = new JPanel();
    redPanel.setBackground(Color.red);
    redPanel.setBounds(0, 0, 250, 250);

    JPanel bluePanel = new JPanel();
    bluePanel.setBackground(Color.blue);
    bluePanel.setBounds(250, 0, 250, 250);

    JPanel greenPanel = new JPanel();
    greenPanel.setBackground(Color.green);
    greenPanel.setBounds(0, 250, 500, 250);
    
    MyFrame myFrame = new MyFrame();
    myFrame.setLayout(null);
    myFrame.add(redPanel);
    redPanel.add(label);
    myFrame.add(bluePanel);
    myFrame.add(greenPanel);
  }
}

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