Java Swing使用GroupLayout布局时首个卡片出现多余边框如何解决

• 同一组件重复添加：代码中仅实例化了1个空白JPanel jp，却在GroupLayout的水平、垂直布局规则中多次重复添加该组件。Swing不支持同一组件多次加入同一容器，会直接导致布局计算逻辑混乱，就是你看到的第一个按钮外围多余空白、窗口缩小时空白变化的核心原因。
• LookAndFeel设置顺序错误：你在创建主面板jpmain之后才设置系统外观，部分组件的渲染规则没有生效，也可能导致边框显示异常。
• 按钮默认边框未显式控制：Swing JButton默认会绘制系统风格的边框，如果你要做纯图标+文字的卡片效果，没有关闭边框绘制也会出现多余的外围边框。

1. 调整LookAndFeel设置顺序，放到所有Swing组件初始化之前
2. 不要复用同一个空白面板做占位，每个占位位置创建独立的空白透明面板，或者直接用GroupLayout的弹性间隙做占位，避免组件重复添加问题
3. 给所有按钮添加边框、背景绘制的关闭配置（按需启用）
4. 调整GroupLayout的布局规则，用弹性间隙实现按钮均匀分布，逻辑更简洁

public class UI2 extends JFrame {

    UI2() {
        // 先设置外观，再初始化所有组件
        try{
            UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
        }catch (Exception e){
            e.printStackTrace();
        }

        setTitle("Dashboard");
        Container c = getContentPane();
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        JPanel jpmain = new JPanel(){
            @Override
            protected void paintComponent(Graphics g) {
                super.paintComponent(g);
                Graphics2D g2d = (Graphics2D) g;
                g2d.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
                int w = getWidth();
                int h = getHeight();
                Color color1 = new Color(90,63,55);
                Color color2 = new Color(44,119,68);
                GradientPaint gp = new GradientPaint(0, 0, color1, 0, h, color2);
                g2d.setPaint(gp);
                g2d.fillRect(0, 0, w, h);
            }
        };
        GroupLayout layout = new GroupLayout(jpmain);
        jpmain.setLayout(layout);
        // 开启自动间隙和容器边距
        layout.setAutoCreateGaps(true);
        layout.setAutoCreateContainerGaps(true);

        JButton btn1 = createBtn("First Menu", "path1");
        JButton btn2 = createBtn("Second Menu", "path2");
        JButton btn3 = createBtn("Third Menu", "path3");
        JButton btn4 = createBtn("Fourth Menu", "path4");
        JButton btn5 = createBtn("Fifth Menu", "path5");

        // 水平布局：实现两行按钮的错落对齐
        layout.setHorizontalGroup(layout.createParallelGroup(GroupLayout.Alignment.CENTER)
                .addGroup(layout.createSequentialGroup()
                        .addComponent(btn1)
                        .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
                        .addComponent(btn2)
                        .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
                        .addComponent(btn3))
                .addGroup(layout.createSequentialGroup()
                        .addComponent(btn4)
                        .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
                        .addComponent(btn5))
        );

        // 垂直布局：两行按钮垂直居中分布
        layout.setVerticalGroup(layout.createSequentialGroup()
                .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
                .addGroup(layout.createParallelGroup(GroupLayout.Alignment.CENTER)
                        .addComponent(btn1)
                        .addComponent(btn2)
                        .addComponent(btn3))
                .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
                .addGroup(layout.createParallelGroup(GroupLayout.Alignment.CENTER)
                        .addComponent(btn4)
                        .addComponent(btn5))
                .addPreferredGap(LayoutStyle.ComponentPlacement.UNRELATED, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
        );

        setExtendedState(JFrame.MAXIMIZED_BOTH);
        c.add(jpmain);
        pack();
    }

    // 抽取按钮创建通用方法，减少重复代码
    private JButton createBtn(String text, String imgPath) {
        ImageIcon image = new ImageIcon(imgPath);
        JButton btn = new JButton(new ImageIcon(image.getImage().getScaledInstance(150,150, java.awt.Image.SCALE_SMOOTH)));
        btn.setText(text);
        btn.setHorizontalTextPosition(SwingConstants.CENTER);
        btn.setVerticalTextPosition(SwingConstants.BOTTOM);
        btn.setFont(new Font("Arial",Font.PLAIN,15));
        // 关闭默认边框、背景、焦点框，不需要可以注释掉
        btn.setBorderPainted(false);
        btn.setContentAreaFilled(false);
        btn.setFocusPainted(false);
        return btn;
    }

    public static void main(String[] args) {
        // Swing组件要在EDT线程初始化
        SwingUtilities.invokeLater(() -> {
            UI2 frame = new UI2();
            frame.setVisible(true);
        });
    }
}

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