自定义BasicButtonUI按钮圆角边框异常：边角外移未被覆盖

问题原因 #

你遇到的边框偏移、边角不对齐问题，核心是**BasicStroke的线条为居中绘制**：设置5像素宽线条时，2.5像素会超出组件边界，2.5像素在内部，导致圆角边框向外“溢出”，和按钮背景/边界不对齐。另外BasicButtonUI默认绘制的方形背景，也会和圆角边框产生视觉冲突。

修复方案 #

1. 修正圆角边框的绘制逻辑

调整RoundedBorder的绘制坐标和尺寸，让边框完全在组件内部，同时优化线条端点和连接方式，让圆角更平滑：

import javax.swing.border.Border;
import java.awt.*;

public class RoundedBorder implements Border {
    private final int radius;
    private final int strokeWidth = 5;

    public RoundedBorder(int radius) {
        this.radius = radius;
    }

    @Override
    public void paintBorder(Component c, Graphics g, int x, int y, int width, int height) {
        Graphics2D g2d = (Graphics2D) g.create();
        // 设置线条为圆角端点和连接，避免尖角
        g2d.setStroke(new BasicStroke(strokeWidth, BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND));
        g2d.setColor(Constants.windowColor);
        
        // 线条居中绘制，向内偏移线条宽度的一半，宽高减去完整线条宽度
        int offset = strokeWidth / 2;
        g2d.drawRoundRect(
                x + offset, 
                y + offset, 
                width - strokeWidth - 1, 
                height - strokeWidth - 1, 
                radius, 
                radius
        );
        g2d.dispose();
    }

    @Override
    public Insets getBorderInsets(Component c) {
        // 设置内边距，避免按钮内容被边框遮挡
        return new Insets(strokeWidth, strokeWidth, strokeWidth, strokeWidth);
    }

    @Override
    public boolean isBorderOpaque() {
        return true;
    }
}

2. 自定义BasicButtonUI绘制圆角背景

覆盖BasicButtonUI的paint方法，绘制圆角背景替代默认方形背景，确保和边框完全对齐：

import javax.swing.plaf.basic.BasicButtonUI;
import javax.swing.*;
import java.awt.*;

public class RoundedButtonUI extends BasicButtonUI {
    private final int radius = 20;

    @Override
    public void paint(Graphics g, JComponent c) {
        AbstractButton button = (AbstractButton) c;
        Graphics2D g2d = (Graphics2D) g.create();

        // 根据按钮状态绘制不同深浅的背景
        if (button.getModel().isPressed()) {
            g2d.setColor(button.getBackground().darker());
        } else if (button.getModel().isRollover()) {
            g2d.setColor(button.getBackground().brighter());
        } else {
            g2d.setColor(button.getBackground());
        }

        // 绘制圆角背景，考虑边框的内边距
        Insets insets = c.getInsets();
        int drawWidth = c.getWidth() - insets.left - insets.right;
        int drawHeight = c.getHeight() - insets.top - insets.bottom;
        g2d.fillRoundRect(insets.left, insets.top, drawWidth, drawHeight, radius, radius);

        // 调用父类方法绘制按钮文本和图标
        super.paint(g2d, c);
        g2d.dispose();
    }
}

3. 按钮初始化代码

JButton b = new JButton("自定义圆角按钮");
b.setUI(new RoundedButtonUI());
b.setBorder(new RoundedBorder(20));
b.setBackground(Color.WHITE); // 设置背景色，避免默认UI的方形背景透出

效果说明 #

• 调整后的边框会完全贴合按钮内部边界，不会出现向外偏移的情况；
• 圆角背景和边框对齐，视觉上统一；
• 内边距设置确保按钮的文本/图标不会被边框遮挡。

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