Java Swing 动画中避免图形残影与界面白屏的正确绘制实践

聖光之護

发布时间：2026-01-11 15:06:42

773人浏览过

来源于php中文网

原创

Java Swing 动画中避免图形残影与界面白屏的正确绘制实践

本文详解如何在 java swing 中实现流畅的自定义动画，重点解决因错误重写 `paint()` 导致的图形扭曲、残影和白屏问题，强调必须继承 `jpanel` 并正确重写 `paintcomponent()` 且首行调用 `super.paintcomponent(g)`。

在 Swing 中实现动画时，一个常见误区是直接继承 JFrame 并重写其 paint() 方法。这不仅违反了 Swing 的绘制约定，还会导致严重的视觉问题：如你所见的“球体扭曲”——实质是旧图像未被正确清除，而手动调用 super.paint() 又可能破坏双缓冲机制，造成大面积白屏或闪烁。

根本原因在于：
Swing 的绘制系统基于组件层级和双缓冲机制。JFrame 是顶级容器，其 paint() 方法负责委托子组件绘制；而真正承载自定义绘图逻辑的应是轻量级组件（如 JPanel），且必须重写 paintComponent(Graphics g) —— 这是 Swing 推荐且安全的绘图入口点。

✅ 正确做法如下：

继承 JPanel 而非 JFrame：将绘图与动画逻辑封装在 JPanel 子类中；
重写 paintComponent() 并首行调用 super.paintComponent(g)：确保背景被自动清除（使用组件默认背景色填充），同时保留双缓冲，避免闪烁；
避免重写 paint() 或 paintComponents()：它们承担特定职责，擅自覆盖易破坏绘制链；
使用 EventQueue.invokeLater() 启动 GUI：保障线程安全性（Swing 是单线程的）。

以下是修正后的完整可运行示例（已精简冗余字段，增强可读性）：

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

public class Animation extends JPanel {
    private int maus1x = 110, maus1y = 350;
    private int maus2x = 55,  maus2y = 350;
    private int maus3x = 0,   maus3y = 350;
    private final Timer timer;

    public Animation() {
        // 设置面板基础属性
        setBackground(Color.WHITE); // 显式设置背景色，确保清除时一致
        setPreferredSize(new Dimension(500, 500));

        // 构建并启动定时器（每100ms触发一次）
        timer = new Timer(100, e -> move());
        timer.start();

        // 创建并配置主窗口
        JFrame frame = new JFrame("MausKampf");
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.setContentPane(this);
        frame.setResizable(false);
        frame.pack(); // 推荐替代 setSize()，更符合布局管理规范
        frame.setLocationRelativeTo(null); // 居中显示
        frame.setVisible(true);
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // ✅ 关键：清除背景并启用双缓冲
        Graphics2D g2d = (Graphics2D) g.create(); // 使用 create() 避免影响后续绘制状态
        g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);

        // 绘制轨道线
        g2d.setColor(Color.BLACK);
        g2d.drawLine(0, 400, 500, 400);
        g2d.drawLine(0, 350, 225, 350);
        g2d.drawLine(275, 350, 500, 350);
        g2d.drawLine(225, 350, 225, 0);
        g2d.drawLine(275, 350, 275, 0);

        // 绘制三只小球（带抗锯齿）
        g2d.setPaint(Color.CYAN);  g2d.fillOval(maus1x, maus1y, 50, 50);
        g2d.setPaint(Color.GREEN); g2d.fillOval(maus2x, maus2y, 50, 50);
        g2d.setPaint(Color.RED);   g2d.fillOval(maus3x, maus3y, 50, 50);

        g2d.dispose(); // 释放资源
    }

    private void move() {
        maus1x += 4;
        maus2x += 4;
        maus3x += 4;

        // 边界检测：当第一只球越过终点线时停止动画
        if (maus1x > 325) {
            timer.stop();
        }
        repaint(); // 请求重绘（线程安全，Swing 自动调度）
    }

    public static void main(String[] args) {
        EventQueue.invokeLater(() -> new Animation());
    }
}

? 关键注意事项：