Java&Swing：为什么组件无法被动态添加到JPanel容器中？

你的代码有4处核心问题导致点击按钮后无法出现预期的青色色块：

• 第一，JPanel默认使用FlowLayout，自定义的JComponent子类没有指定首选大小，布局管理器会忽略你调用的setSize设置，直接把组件大小压缩为0，所以看不见
• 第二，自定义JComponent默认是透明的，你设置的setBackground不会生效，需要手动开启不透明属性，或者在paintComponent里自己绘制背景色
• 第三，你在paintComponent里没有调用父类的方法，会导致组件绘制出现脏区问题
• 第四，给mainPanel动态添加组件后，没有调用revalidate()和repaint()触发布局重算和重绘，新加的组件不会被渲染

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class TestFrame extends JFrame {
    public static void main(String[] args) {
        EventQueue.invokeLater(() -> {
            final TestFrame mainFrame = new TestFrame();
            mainFrame.setDefaultCloseOperation(EXIT_ON_CLOSE);
            mainFrame.setVisible(true);
        });
    }

    public TestFrame() throws HeadlessException {
        setTitle("Frame");
        setSize(new Dimension(1000, 800));
        final JPanel mainPanel = new JPanel();

        final JButton button = new JButton("Test");
        button.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                System.out.println(e.getActionCommand());
                mainPanel.add(new Unit());
                // 动态添加组件后触发重布局和重绘
                mainPanel.revalidate();
                mainPanel.repaint();
            }
        });

        mainPanel.add(button);
        add(mainPanel);
    }

    class Unit extends JComponent {
        public Unit() {
            // 设置首选大小供布局管理器参考
            setPreferredSize(new Dimension(100, 100));
            setBackground(Color.CYAN);
            // 开启组件不透明，背景色才会生效
            setOpaque(true);
        }

        @Override
        protected void paintComponent(Graphics g) {
            // 调用父类方法完成基础绘制，包括填充背景色
            super.paintComponent(g);
            final Graphics2D g2D = (Graphics2D) g;
            g2D.drawString("Hello World", 10, 20);
        }
    }
}

• 给Unit类构造方法添加了setPreferredSize(new Dimension(100, 100))，替代之前的setSize，布局管理器会优先读取首选大小参数
• 添加了setOpaque(true)开启组件不透明属性，背景色设置才能生效
• paintComponent第一行调用super.paintComponent(g)，完成背景填充等基础绘制逻辑
• 按钮点击事件中添加完Unit组件后，调用mainPanel.revalidate()触发布局重算，调用mainPanel.repaint()触发界面重绘
• 调整了绘制文字的Y坐标从10改成20，避免文字顶部被容器裁剪看不到

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