1. 使用 JButton 的 setIcon() 方法：这是最直接、最常用的方法，将一个 ImageIcon 对象设置给按钮。
2. 使用 JButton 的 paintComponent() 方法进行自定义绘制：这种方法更灵活，可以让你完全控制按钮的绘制过程，例如实现图片拉伸、平铺或更复杂的交互效果。

下面我将详细介绍这两种方法,并提供完整的代码示例。

使用 setIcon() (最常用)

这是最简单直接的方法，你需要准备一张图片，然后创建一个 ImageIcon 对象,并将其设置为按钮的图标。

步骤：

1. 准备图片：将你的图片文件（my_button.png）放在项目的资源文件夹中（通常是 src 目录）。
2. 创建 ImageIcon：使用 new ImageIcon("图片路径") 来加载图片。
3. 创建 JButton：创建一个 JButton 实例。
4. 设置图标：调用 button.setIcon(icon) 将图标应用到按钮上。

完整代码示例

import javax.swing.*;
import java.awt.*;
public class JButtonWithIconExample {
    public static void main(String[] args) {
        // 1. 创建主窗口
        JFrame frame = new JFrame("JButton 图片示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(400, 300);
        frame.setLayout(new FlowLayout()); // 使用流式布局，让按钮居中显示
        // 2. 准备图片路径
        // 假设图片名为 "icon.png" 并且位于 src 目录下
        String imagePath = "icon.png"; 
        // 3. 创建 ImageIcon
        // 使用 try-with-resources 确保 ImageInputStream 被正确关闭（虽然 ImageIcon 内部处理了，但这是好习惯）
        // 如果图片路径错误，ImageIcon 构造函数不会抛出异常，但后续 isLoaded() 会返回 false
        ImageIcon icon = new ImageIcon(imagePath);
        // 4. 检查图片是否成功加载
        if (icon.getImageLoadStatus() != MediaTracker.COMPLETE) {
            System.err.println("错误：无法加载图片，请检查路径: " + imagePath);
            // 可以设置一个默认文本或使用一个占位符图标
            JButton errorButton = new JButton("图片加载失败");
            frame.add(errorButton);
        } else {
            // 5. 创建 JButton 并设置图标
            JButton buttonWithIcon = new JButton("点击我", icon);
            // (可选) 设置按钮文本和图标的相对位置
            buttonWithIcon.setHorizontalTextPosition(SwingConstants.CENTER); // 文字水平居中
            buttonWithIcon.setVerticalTextPosition(SwingConstants.BOTTOM);  // 文字在图标下方
            // (可选) 去除按钮的边框和背景，使其看起来更像是标签
            // buttonWithIcon.setBorderPainted(false);
            // buttonWith.setContentAreaFilled(false);
            // 6. 将按钮添加到窗口
            frame.add(buttonWithIcon);
        }
        // 7. 显示窗口
        frame.setVisible(true);
    }
}

如何运行这个示例：

1. 在你的 IDE (如 IntelliJ IDEA 或 Eclipse) 中创建一个新的 Java 项目。
2. 将上面的代码复制到一个名为 JButtonWithIconExample.java 的文件中。
3. 在 src 目录下，创建一个名为 icon.png 的图片文件（或者从网上下载一个小图片，命名为 icon.png 并放入 src）。
4. 运行 main 方法。

关键点说明：

• 图片路径：路径是相对于项目根目录的，如果你的图片在 src/resources 文件夹下，路径应该是 "resources/icon.png"。
• ImageIcon 的健壮性：如果图片路径错误，new ImageIcon() 不会抛出 FileNotFoundException，它只是会创建一个无效的 ImageIcon，最好使用 getImageLoadStatus() 方法来检查图片是否成功加载。
• 文本位置：setHorizontalTextPosition 和 setVerticalTextPosition 方法非常有用，可以控制文本相对于图标的位置，常用值有 SwingConstants.LEFT, RIGHT, CENTER, TOP, BOTTOM。

自定义 JButton (更灵活)

当你需要对按钮的绘制进行更精细的控制时（让图片拉伸以填满按钮、添加悬停效果等），你可以继承 JButton 并重写其 paintComponent(Graphics g) 方法。

步骤：

1. 创建自定义按钮类：继承 JButton。
2. 声明图片字段：在自定义类中声明一个 Image 字段来存储图片。
3. 加载图片：在构造函数中，使用 ImageIO.read() 加载图片，这种方法比 ImageIcon 更底层,可以更好地处理异常。
4. 重写 paintComponent：在这个方法中，使用 Graphics 对象的 drawImage() 方法将图片绘制到按钮上。

完整代码示例

import javax.swing.*;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.IOException;
import javax.imageio.ImageIO;
public class CustomImageButtonExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("自定义图片按钮示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(400, 300);
        frame.setLayout(new FlowLayout());
        try {
            // 创建我们的自定义按钮
            CustomImageButton customButton = new CustomImageButton("stretched_button.png");
            frame.add(customButton);
        } catch (IOException e) {
            System.err.println("无法加载图片: " + e.getMessage());
            // 如果加载失败，添加一个普通按钮作为备用
            frame.add(new JButton("图片加载失败"));
        }
        frame.setVisible(true);
    }
}
// 自定义按钮类
class CustomImageButton extends JButton {
    private Image image; // 存储加载的图片
    // 构造函数，接收图片路径
    public CustomImageButton(String imagePath) throws IOException {
        // 设置按钮为不透明，这样背景色才能显示
        setOpaque(false);
        // 设置边框为空
        setBorder(null);
        // 去除焦点边框，点击时没有虚线框
        setFocusPainted(false);
        // 使用 ImageIO 加载图片，可以更好地处理异常
        image = ImageIO.read(getClass().getResource(imagePath));
    }
    @Override
    protected void paintComponent(Graphics g) {
        // 1. 绘制图片，使其拉伸以填满整个按钮区域
        // g.drawImage(image, 0, 0, getWidth(), getHeight(), this);
        // 2. (更好的方式) 使用 Graphics2D 进行高质量缩放
        Graphics2D g2d = (Graphics2D) g.create();
        // 启用图像平滑
        g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);
        // 绘制拉伸后的图片
        g2d.drawImage(image, 0, 0, getWidth(), getHeight(), this);
        g2d.dispose();
        // 2. (可选) 绘制文本
        // 如果需要绘制文本，应该在图片绘制之后
        super.paintComponent(g); // 这会绘制按钮的文本
    }
}

如何运行这个示例：

1. 创建项目，将代码保存为 CustomImageButtonExample.java 和 CustomImageButton.java。
2. 在 src 目录下放置一张名为 stretched_button.png 的图片。
3. 运行 CustomImageButtonExample 的 main 方法。

关键点说明：

• ImageIO.read() vs new ImageIcon()：
  • ImageIO.read() 是 Java 标准库的一部分，返回一个 BufferedImage，它能更准确地报告文件 I/O 错误（通过抛出 IOException）,适合在构造函数中使用。
  • new ImageIcon() 更简单,但错误处理更隐晦。
• paintComponent() 的工作原理：Swing 组件在需要重绘时（如窗口大小改变、按钮被点击）会调用这个方法,我们在这里接管了整个绘制过程。
• 图片缩放：g.drawImage(image, x, y, width, height, observer) 的后四个参数可以指定图片的绘制尺寸和位置，我们将其设置为按钮的宽高,就实现了拉伸效果。
• Graphics2D 和 RenderingHints：使用 Graphics2D 可以获得更强大的绘图功能，比如设置抗锯齿（平滑处理）,让拉伸后的图片看起来更清晰。
• 调用 super.paintComponent(g)：如果你想在图片上显示按钮的默认文本（例如通过 setText() 设置的），就必须调用 super.paintComponent(g),它会执行默认的文本绘制逻辑。

总结与对比

建议：

• 如果只是想在按钮上显示一张固定大小的图片，并控制文字位置，首选 setIcon()，它简单、可靠，且是 Swing 的标准用法。
• 如果你需要让图片拉伸以适应按钮大小、实现鼠标悬停时图片变化、或者绘制一个圆形图片按钮等，那么自定义 paintComponent() 是正确的选择。