如何在JFrame中添加高质量图片？解决图片显示模糊问题

问题根源 #

Windows 11的125%缩放比例属于高DPI场景，Java Swing默认渲染逻辑未适配高DPI环境，导致图片被低质量缩放后显示，细节丢失。

解决方案 #

1. 启用Java高DPI支持

可以通过VM参数或代码内设置系统属性来开启高DPI适配：

• VM参数方式：
  运行程序时添加以下参数：

  -Dsun.java2d.uiScale=1 -Djdk.awt.allowPixelArt=true
  

  （Java 9+推荐，allowPixelArt可避免像素风格图片被强制模糊处理）
• 代码内设置方式：
  在main方法最开头添加静态代码块：

  static {
      System.setProperty("sun.java2d.uiScale", "1");
      System.setProperty("jdk.awt.allowPixelArt", "true");
  }
  

2. 使用高质量渲染绘制图片

自定义JLabel并重写paintComponent方法，启用高质量渲染提示，确保图片绘制时的插值和渲染质量：

import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.image.BufferedImage;
import javax.swing.JLabel;

class HighQualityImageLabel extends JLabel {
    private BufferedImage image;

    public HighQualityImageLabel(BufferedImage image) {
        this.image = image;
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        Graphics2D g2d = (Graphics2D) g.create();
        
        // 开启高质量渲染参数
        g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC);
        g2d.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
        g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        
        // 绘制图片，适配Label尺寸（固定尺寸可调整此处参数）
        g2d.drawImage(image, 0, 0, getWidth(), getHeight(), this);
        g2d.dispose();
    }
}

替换原代码中的JLabel创建逻辑：

// 替换原代码：JLabel schemeLabel = new JLabel(new ImageIcon(image));
JLabel schemeLabel = new HighQualityImageLabel(image);

3. 避免使用Null布局

Null布局会忽略系统DPI缩放设置，导致组件尺寸计算错误。改用标准布局管理器，比如BorderLayout：

// 替换原代码：frame.setLayout(null);
frame.setLayout(new BorderLayout());
// 移除原代码的setBounds语句，改用布局管理器管理位置
frame.add(schemeLabel, BorderLayout.CENTER);

验证效果 #

完成上述修改后重新运行程序，图片细节应能正常显示，匹配原图质量。

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