PaintComponent绘制内容未显示在窗体上的技术求助

看起来你遇到的是Swing绘制中很常见的几个小坑，我帮你梳理下最可能的原因和解决办法：

常见问题及修复方案 #

1. 没有正确重写paintComponent方法 #

很多新手会忘记加@Override注解，或者方法签名写错（比如大小写错误、参数类型不对）。如果没重写对，JVM不会调用你的自定义绘制逻辑，自然看不到文本。

必须添加@Override注解，这样编译器会帮你检查方法签名是否正确，避免低级错误。

2. 遗漏super.paintComponent(g)调用 #

这是最容易忽略的点！super.paintComponent(g)负责执行JPanel的基础绘制逻辑：清理画布、绘制背景色、处理组件的opaque属性等等。如果跳过这一步，你的文本可能被覆盖，或者绘制上下文异常导致内容不显示。

3. 文本绘制位置不合理 #

Graphics.drawString()的第三个参数是文本基线的y坐标，不是左上角的y值。如果把y设成0或者很小的数值，文本会被窗口的标题栏/边框挡住，看起来就像没显示。

4. Panel未正确添加到窗口或大小设置不当 #

如果你的自定义Panel没有被添加到JFrame，或者JFrame没有设置大小、Panel没有填充窗口，也会导致文本看不到。

修正后的完整代码示例 #

自定义Panel类（规范写法） #

package com.learn.java;
import javax.swing.*;
import java.awt.*;

// 类名首字母大写，符合Java命名规范
class MyPanel extends JPanel {
    // 必须加@Override，确保重写父类的paintComponent方法
    @Override
    protected void paintComponent(Graphics g) {
        // 先调用父类方法，完成基础绘制
        super.paintComponent(g);
        
        // 可选：设置文本颜色和字体，让内容更醒目
        g.setColor(Color.DARK_GRAY);
        g.setFont(new Font("微软雅黑", Font.PLAIN, 24));
        
        // 把文本画在窗口可见区域内（x=30, y=50，避免被边框挡住）
        g.drawString("这是paintComponent绘制的文本", 30, 50);
    }
}

Main主类（规范的Swing启动方式） #

package com.learn.java;
import javax.swing.*;

public class Main {
    public static void main(String[] args) {
        // Swing组件必须在事件调度线程(EDT)中创建，避免线程安全问题
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("测试绘制窗口");
            // 设置窗口关闭时退出程序
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            // 添加自定义Panel到窗口（默认BorderLayout.CENTER，会填充整个窗口）
            frame.add(new MyPanel());
            // 设置窗口大小
            frame.setSize(450, 300);
            // 让窗口居中显示
            frame.setLocationRelativeTo(null);
            // 显示窗口
            frame.setVisible(true);
        });
    }
}

你可以对照检查自己的代码： #

• 有没有加@Override注解？
• 有没有调用super.paintComponent(g)？
• 文本的绘制坐标是不是在窗口可见范围内？
• 自定义Panel是否被正确添加到JFrame？
• JFrame是否设置了大小并调用了setVisible(true)？

按照上面的修正，应该就能看到paintComponent里的文本了。

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