Java Swing 如何跟随操作系统分辨率与缩放比例跨平台调整字体及GUI组件大小

问题根因 #

• 这类现象是Linux平台下Java Swing高DPI缩放的历史兼容缺陷：JDK 17之前的版本，对KDE/GNOME等Linux桌面环境的非整数倍缩放（如150%）支持存在硬编码限制，默认仅能识别Windows/macOS平台的系统缩放配置，Linux环境下会直接回退到Metal观感的默认像素尺寸，完全不读取系统设置的缩放比例。
• 测试中传入-Dsun.java2d.uiScale=1.5不生效，是JDK 12~16版本的已知问题：这些版本的Java2D缩放引擎对非整数倍缩放的计算存在逻辑bug，部分场景下会直接忽略浮点数格式的缩放参数。
• 你查到的OpenJDK issue（编号JDK-8260270）确实对应这类场景，它的修复版本为JDK 17，但修复仅覆盖了Linux下整数倍缩放的识别能力，非整数倍缩放的适配在后续小版本才逐步完善，你使用的JDK12/14版本完全不包含这部分适配能力。
• Windows 7环境下缩放正常的现象也符合上述逻辑：Windows平台的缩放识别是JDK最早支持的能力，不存在Linux下的兼容问题。

跨平台适配实现方案 #

以下代码兼容JDK 8及以上版本，不需要用户手动传入JVM启动参数，可自动识别系统全局缩放比例，覆盖Windows、macOS、Kubuntu/Ubuntu等Linux桌面环境，解决Linux下字体偏小的问题。

步骤1：编写系统缩放比例识别工具类 #

import java.awt.DisplayMode;
import java.awt.GraphicsEnvironment;
import java.awt.Toolkit;
import java.util.Locale;

public class UiScaleUtil {
    /**
     * 获取当前系统全局UI缩放比例，返回值1.0对应100%缩放，1.5对应150%缩放
     */
    public static double getSystemUiScale() {
        // 优先读取高版本JDK本身识别到的系统缩放值（适配Windows/macOS环境）
        String scaleProp = System.getProperty("sun.java2d.uiScale", "");
        if (!scaleProp.isEmpty()) {
            try {
                return Double.parseDouble(scaleProp);
            } catch (NumberFormatException ignored) {}
        }

        // 针对Linux环境做兜底识别
        String os = System.getProperty("os.name", "").toLowerCase(Locale.ROOT);
        if (os.contains("linux")) {
            // 读取KDE/GNOME桌面环境的全局缩放配置
            String desktopScale = System.getenv("KDE_FULL_SESSION") != null 
                ? readKdeScale() 
                : readGnomeScale();
            if (desktopScale != null && !desktopScale.isEmpty()) {
                try {
                    return Double.parseDouble(desktopScale);
                } catch (NumberFormatException ignored) {}
            }

            // 针对常见2K屏配置的兜底计算
            GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
            DisplayMode dm = ge.getDefaultScreenDevice().getDisplayMode();
            int screenWidth = dm.getWidth();
            // 27寸2K屏常规配置为150%缩放
            if (screenWidth >= 2560) {
                return 1.5;
            }
        }

        // 跨平台通用兜底：通过系统DPI计算缩放比例（基准DPI为96）
        int screenDpi = Toolkit.getDefaultToolkit().getScreenResolution();
        return screenDpi / 96.0;
    }

    // 读取KDE环境下的缩放配置
    private static String readKdeScale() {
        try {
            // 通过系统DPI计算KDE下的实际缩放值
            int dpi = Toolkit.getDefaultToolkit().getScreenResolution();
            return String.valueOf(dpi / 96.0);
        } catch (Exception e) {
            return null;
        }
    }

    // 读取GNOME环境下的缩放配置
    private static String readGnomeScale() {
        try {
            Process p = Runtime.getRuntime().exec(new String[]{"gsettings", "get", "org.gnome.desktop.interface", "text-scaling-factor"});
            byte[] out = p.getInputStream().readAllBytes();
            return new String(out).trim().replace("'", "");
        } catch (Exception e) {
            return null;
        }
    }
}

步骤2：在UI组件初始化前应用缩放配置 #

必须在创建任何Swing组件之前完成缩放设置，才能保证所有组件的尺寸正确生效：

public class Test extends JFrame {
    public Test() {
        setTitle("Test window");
        JPanel panel = new JPanel(new BorderLayout());
        panel.add(new JLabel("This is a test label. Consider the font size "
                + "relative to the frame title size."), BorderLayout.NORTH);
        panel.add(new JButton("This is a test button"), BorderLayout.SOUTH);
        add(panel);
        pack();
        setLocationRelativeTo(null);
        setVisible(true);
    }

    public static void main(String[] args) {
        // 识别系统缩放比例
        double scale = UiScaleUtil.getSystemUiScale();
        // 设置Java2D渲染缩放
        System.setProperty("sun.java2d.uiScale", String.valueOf(scale));
        
        // 针对非整数倍缩放，全局调整所有Swing组件的默认字体大小
        // 兼容JDK12-16版本对浮点数缩放参数识别失败的问题
        if (Math.abs(scale - 1.0) > 0.01) {
            java.util.Enumeration<Object> keys = javax.swing.UIManager.getDefaults().keys();
            while (keys.hasMoreElements()) {
                Object key = keys.nextElement();
                Object value = javax.swing.UIManager.get(key);
                if (value instanceof java.awt.Font) {
                    java.awt.Font font = (java.awt.Font) value;
                    javax.swing.UIManager.put(key, font.deriveFont(font.getSize2D() * scale));
                }
            }
        }

        // 在事件 dispatch 线程初始化UI
        javax.swing.SwingUtilities.invokeLater(Test::new);
    }
}

注意事项 #

• 不需要强制切换系统观感：Linux环境下JDK的系统观感实现不完善，会自动回退到Metal观感，这是正常现象。上述全局字体调整逻辑对Metal、Nimbus等所有Swing观感都生效。
• 非整数倍缩放的兼容：由于低版本JDK对sun.java2d.uiScale的浮点数参数支持存在bug，方案没有依赖该参数完成实际尺寸调整，而是直接修改UIManager中的全局默认字体，配合Java2D渲染缩放，即可匹配150%这类非整数缩放的效果，完全不需要用户手动在终端添加启动参数。
• 跨平台一致性：Windows/macOS环境下，JDK本身就能正确识别系统缩放，工具类会直接读取识别到的缩放值，不会出现额外的适配偏差。

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