Swing JLabel图标HiDPI适配：避免缩放与多分辨率问题

1. 正确使用BaseMultiResolutionImage实现多分辨率适配 #

核心是为系统常见DPI缩放比例（100%=1.0x、125%=1.25x、150%=1.5x、175%=1.75x、200%=2.0x等）准备对应尺寸的高清图标，再将图标与对应缩放因子绑定为分辨率变体，最终生成多分辨率图片。

示例代码：

// 加载对应缩放比例的高清图标（建议用矢量源导出，避免拉伸）
Image icon1x = Toolkit.getDefaultToolkit().getImage("icon_16x16.png"); // 100%
Image icon1_25x = Toolkit.getDefaultToolkit().getImage("icon_20x20.png"); // 125%
Image icon1_5x = Toolkit.getDefaultToolkit().getImage("icon_24x24.png"); // 150%
Image icon1_75x = Toolkit.getDefaultToolkit().getImage("icon_28x28.png"); // 175%
Image icon2x = Toolkit.getDefaultToolkit().getImage("icon_32x32.png"); // 200%

// 创建分辨率变体，绑定图标与对应缩放因子
BaseMultiResolutionImage.ResolutionVariant[] variants = {
    new BaseMultiResolutionImage.ResolutionVariant(icon1x, 1.0f),
    new BaseMultiResolutionImage.ResolutionVariant(icon1_25x, 1.25f),
    new BaseMultiResolutionImage.ResolutionVariant(icon1_5x, 1.5f),
    new BaseMultiResolutionImage.ResolutionVariant(icon1_75x, 1.75f),
    new BaseMultiResolutionImage.ResolutionVariant(icon2x, 2.0f)
};

// 实例化多分辨率图片并设置给JLabel
MultiResolutionImage multiResImage = new BaseMultiResolutionImage(variants);
JLabel label = new JLabel(new ImageIcon(multiResImage));

关键注意点：

• 图标尺寸需严格按「基础尺寸×缩放因子」计算（如16×1.75=28），避免用低分辨率图标拉伸生成高分辨率版本。
• 缩放因子必须与系统DPI缩放比例完全对应，确保系统能精准匹配到最合适的图标变体。

2. 无对应分辨率图标时设置默认图标 #

有两种可靠方式实现 fallback：

• 方式一：默认包含基础1.0x图标
  在分辨率变体数组中始终加入1.0x的基础图标，当系统找不到完全匹配的缩放因子时，会自动选择最接近的变体，若无更接近的则使用1.0x图标。
• 方式二：自定义MultiResolutionImage逻辑
  重写getResolutionVariant方法，手动指定无匹配时的默认图标，示例：

MultiResolutionImage customMultiResImage = new MultiResolutionImage() {
    private final Image defaultIcon = Toolkit.getDefaultToolkit().getImage("icon_16x16.png");
    private final Map<Float, Image> variantMap = Map.of(
        1.5f, Toolkit.getDefaultToolkit().getImage("icon_24x24.png"),
        2.0f, Toolkit.getDefaultToolkit().getImage("icon_32x32.png")
    );

    @Override
    public Image getResolutionVariant(double destWidth, double destHeight) {
        // 计算当前缩放因子（以基础尺寸16为例）
        float scale = (float) (destWidth / 16);
        // 匹配最接近的缩放因子
        Float closestScale = variantMap.keySet().stream()
            .min(Comparator.comparingDouble(s -> Math.abs(s - scale)))
            .orElse(null);
        return closestScale != null ? variantMap.get(closestScale) : defaultIcon;
    }

    @Override
    public List<Image> getResolutionVariants() {
        List<Image> variants = new ArrayList<>(variantMap.values());
        variants.add(defaultIcon);
        return variants;
    }
};

3. 更换对应尺寸图标后显示异常（锯齿）的原因及解决方法 #

常见原因 #

1. 图标本身非高清源导出：用低分辨率图标拉伸生成高分辨率版本，边缘必然出现锯齿。
2. 缩放因子匹配错误：系统当前DPI缩放比例（如175%=1.75x）无对应变体，系统被迫拉伸其他尺寸图标适配。
3. Swing HiDPI支持未开启：系统未自动启用HiDPI适配逻辑，导致图标仍按旧逻辑缩放。

解决方法 #

• 重新导出高清图标：用SVG等矢量源文件，按对应缩放比例导出精准尺寸的PNG图标，确保边缘清晰。
• 核对缩放因子与系统DPI的对应关系：Windows DPI缩放比例对应的因子为：100%=1.0、125%=1.25、150%=1.5、175%=1.75、200%=2.0，需严格对应创建变体。
• 强制开启Swing HiDPI支持：在应用启动最早期设置系统属性：

public static void main(String[] args) {
    // 必须在创建GUI前设置
    System.setProperty("sun.java2d.uiScale", "auto");
    SwingUtilities.invokeLater(() -> {
        JFrame frame = new JFrame("HiDPI Test");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        // 添加带多分辨率图标的组件
        frame.pack();
        frame.setVisible(true);
    });
}

• 禁用手动缩放：不要使用Image.getScaledInstance()方法，完全依赖BaseMultiResolutionImage自动选择变体。

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