为何添加到JComponent的Java Swing组件无法被绘制显示？

你遇到的核心问题是JComponent默认没有布局管理器，而JPanel默认使用FlowLayout——这就是为什么你在JPanel里添加组件能正常显示，JComponent里却不行的原因。虽然你已经把JTextField添加到JComponent里了，但因为没有布局管理器来计算组件的位置和大小，它就不会被渲染到可见区域，不过组件本身是存在的（你能通过键盘事件触发就是证明）。

接下来给你几个可行的解决步骤，结合你的代码修改：

1. 给JComponent设置布局管理器 #

在TestJComponent的构造方法里，添加一行设置布局的代码，比如用默认的FlowLayout：

setLayout(new FlowLayout());

这样JComponent就会像JPanel一样自动管理子组件的布局，帮你计算并设置子组件的位置和大小。

2. 正确重写paintComponent方法（而非paint） #

Swing组件的绘制规范是重写paintComponent，而不是直接重写paint。而且一定要先调用super.paintComponent(g)，它会帮你处理背景填充、子组件绘制等基础工作，不需要手动去做这些重复劳动（除非你有特殊的自定义绘制需求）。

3. 移除不必要的手动绘制代码 #

你在paint方法里手动调用_text1.paintComponents(g)是完全没必要的，Swing的绘制体系会自动处理子组件的绘制流程，只要布局管理器正确设置，子组件就会被正常渲染。

修改后的TestJComponent代码： #

public class TestJComponent extends JComponent {
    public TestJComponent() {
        setPreferredSize(new Dimension(100, 30));
        // 关键：给JComponent添加布局管理器
        setLayout(new FlowLayout());
        
        _text1 = new JTextField(6);
        _text1.addKeyListener(new KeyAdapter() {
            public void keyPressed(KeyEvent e) {
                _label1.setText(_text1.getText());
                _label1.repaint();
            }
        });
        _text1.setOpaque(true);
        add(_text1);
        
        setOpaque(true);
        setBackground(Color.green);
    }

    // 遵循Swing规范，重写paintComponent而非paint
    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        // 如果需要自定义绘制（比如画额外的图形），在这里添加代码即可
        // 不需要手动填充背景，super.paintComponent会自动处理（因为setOpaque(true)）
    }
}

额外说明： #

• 为什么JPanel默认能行？因为JPanel的构造方法里默认调用了setLayout(new FlowLayout())，而JComponent的构造方法没有这一步。
• 永远遵循Swing的绘制规则：重写paintComponent、调用super方法、不要手动干预子组件的绘制流程。
• 如果你不需要自定义绘制逻辑，其实直接用JPanel就足够了，没必要用JComponent。只有当你需要完全自定义绘制行为时，才考虑继承JComponent。

这样修改后，你的JTextField就能在JComponent里正常显示和交互了。

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