继承BasicButtonUI后JButton无边框和背景的问题排查

你遇到的边框和背景丢失问题，本质是错误地直接继承BasicButtonUI替换按钮原有UI。不同系统LookAndFeel（LAF）的按钮UI有各自的实现：比如WindowsLAF用WindowsButtonUI、Nimbus用NimbusButtonUI，这些子类重写了paint、update等核心方法来绘制符合系统风格的边框和背景。当你强制替换为BasicButtonUI的子类时，原有LAF的样式绘制逻辑被完全覆盖，只有MotifLAF的UI逻辑与Basic底层实现更契合，所以表现正常。

要保留原有LAF样式同时添加自定义绘制，正确思路是基于当前LAF的默认按钮UI做扩展，而非从零继承BasicButtonUI。通过代理原有UI实例，先执行原生样式绘制，再叠加自定义内容。

import javax.swing.*;
import javax.swing.plaf.ButtonUI;
import java.awt.*;

public class QButtonUI extends ButtonUI {
    private final ButtonUI delegateUI;

    private QButtonUI(ButtonUI delegate) {
        this.delegateUI = delegate;
    }

    public static QButtonUI createUI(JButton button) {
        // 获取当前LAF为按钮提供的原生UI实例
        ButtonUI defaultUI = UIManager.getUI(button);
        QButtonUI customUI = new QButtonUI(defaultUI);
        button.setUI(customUI);
        return customUI;
    }

    // 先绘制原生LAF样式，再叠加自定义线条
    @Override
    public void paint(Graphics g, JComponent c) {
        delegateUI.paint(g, c);
        g.setColor(Color.ORANGE);
        g.drawLine(0, 20, 20, 0);
    }

    // 按下状态同样先绘制原生样式，再添加自定义标记
    @Override
    protected void paintButtonPressed(Graphics g, AbstractButton b) {
        delegateUI.paintButtonPressed(g, b);
        g.setColor(Color.RED);
        g.drawLine(0, 0, 20, 20);
    }

    // 代理其他UI生命周期方法，保证原生逻辑正常执行
    @Override
    public void update(Graphics g, JComponent c) {
        delegateUI.update(g, c);
    }

    @Override
    public void installUI(JComponent c) {
        delegateUI.installUI(c);
    }

    @Override
    public void uninstallUI(JComponent c) {
        delegateUI.uninstallUI(c);
    }
}

• 这种代理模式兼容所有LAF，因为完全保留了原生UI的实现逻辑，仅在绘制阶段追加自定义内容
• 如果只针对特定LAF开发（比如仅Windows），也可以直接继承对应LAF的UI类（如WindowsButtonUI），但通用性会下降
• 不要跳过父类的update、paint等核心方法调用，很多LAF的这些方法会处理背景填充、双缓冲、主题适配等关键逻辑

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