Java Swing为JButton设置图标后图标显示失真的解决方法

• JButton默认自带内容内边距（Insets），常规默认值为(2,2,2,2)，即便你将按钮设为20x20，实际留给图标的渲染区域被压缩到16x16，20x20的图标被强制拉伸/压缩，自然出现失真模糊。
• Nimbus等UI主题的默认按钮边框、背景填充会额外占用内容空间，进一步挤压图标渲染区域。
• 直接通过文件路径加载ImageIcon时没有做高质量缩放处理，高DPI屏幕下会触发二次缩放，加剧失真。

• 移除按钮默认内边距
  手动将按钮的边距设置为0，把全部20x20的空间留给图标渲染，对应代码：
  jButton1.setMargin(new Insets(0, 0, 0, 0));
  注：需要导入java.awt.Insets类完成编译。
• 关闭默认按钮边框与背景填充
  纯图标场景下不需要文字按钮的默认边框和灰色背景填充，避免这些元素抢占渲染空间、遮挡图标：

jButton1.setBorderPainted(false);
jButton1.setContentAreaFilled(false);

如果需要保留交互反馈的悬停、点击效果，可以改用空边框替代默认边框，不要让边框挤压图标渲染区域。

• 高质量加载并缩放图标
  不要直接用原始路径加载图标，先对图标做平滑缩放到20x20尺寸，避免像素拉伸锯齿：

// 从类路径加载原始图标资源，避免打包后路径找不到的问题
ImageIcon rawIcon = new ImageIcon(Test.class.getResource("/icons/你的图标文件.png"));
// 用平滑缩放模式生成适配20x20尺寸的图像
Image scaledImage = rawIcon.getImage().getScaledInstance(20, 20, Image.SCALE_SMOOTH);
jButton1.setIcon(new ImageIcon(scaledImage));

• 调整代码执行顺序
  一定要在设置完内边距、边框、图标之后，再给按钮设置固定的20x20尺寸（minimum、maximum、preferredSize），否则Swing会根据默认内边距自动重算组件大小，覆盖你手动设置的尺寸值。
  调整后的按钮初始化代码参考：

private void initComponents() {
    jButton1 = new javax.swing.JButton();
    setDefaultCloseOperation(javax.swing.WindowConstants.EXIT_ON_CLOSE);
    getContentPane().setLayout(new javax.swing.BoxLayout(getContentPane(), javax.swing.BoxLayout.LINE_AXIS));

    // 先去掉占空间的元素
    jButton1.setBorderPainted(false);
    jButton1.setContentAreaFilled(false);
    jButton1.setMargin(new Insets(0, 0, 0, 0));
    // 加载缩放后的图标
    ImageIcon rawIcon = new ImageIcon(Test.class.getResource("/icons/your_icon.png"));
    Image scaledImg = rawIcon.getImage().getScaledInstance(20, 20, Image.SCALE_SMOOTH);
    jButton1.setIcon(new ImageIcon(scaledImg));
    // 最后设置固定尺寸
    jButton1.setMinimumSize(new java.awt.Dimension(20, 20));
    jButton1.setMaximumSize(new java.awt.Dimension(20, 20));
    jButton1.setPreferredSize(new java.awt.Dimension(20, 20));

    getContentPane().add(jButton1);
    pack();
}

注意：如果使用NetBeans可视化UI编辑器开发，不要直接修改// <editor-fold ...>标记包裹的自动生成代码区，可选中按钮后在右侧属性面板中直接设置margin为(0,0,0,0)、borderPainted为false、contentAreaFilled为false，避免编辑器重生成代码时覆盖你的修改。

• 高DPI场景适配
  如果是在高分辨率屏幕（4K、视网膜屏）下运行，可在初始化UI前添加属性设置，避免UI自动缩放组件导致图标二次拉伸：
  System.setProperty("sun.java2d.uiScale", "1.0");

内容的提问来源于stack exchange，提问作者Christian O.