如何优化JPanel边距与内边距，解决Java Swing窗口resize后组件间距过大问题

问题根因 #

你遇到的布局异常本质是GridLayout的特性导致的：GridLayout会强制所有单元格尺寸完全相等，窗口放大时所有多余空间会平均分配给每个单元格，最终表现为组件间的空白边距被无限撑大。

修复方案 #

1. 布局调整（固定组件间距） #

推荐改用GridBagLayout，通过参数配置实现多余空间仅分配给文本框组件，而非空白间距：

• 给文本框所在列设置weightx=1.0，所有水平方向多余空间全部分配给文本框，标签列宽度保持固定
• fill参数设为GridBagConstraints.HORIZONTAL，让文本框仅水平拉伸，高度保持固定
• insets参数设置固定的组件间距，不会随窗口缩放变化
• 垂直方向设置weighty=0，所有多余垂直空间堆积在面板底部，不会撑大组件行间距

2. 文本框文字自适应大小实现 #

给JTextField添加组件尺寸监听器，监听大小变化事件后动态计算适配的字体大小：

private void adjustTextFieldFont(JTextField textField) {
    int textFieldWidth = textField.getWidth();
    int textFieldHeight = textField.getHeight();
    if (textFieldWidth <=0 || textFieldHeight <=0) return;
    // 从12号字体开始递增测试最大适配字号
    float fontSize = 12f;
    Font tempFont;
    FontMetrics metrics;
    while (true) {
        tempFont = textField.getFont().deriveFont(fontSize + 1f);
        metrics = textField.getFontMetrics(tempFont);
        if (metrics.stringWidth(textField.getText()) < textFieldWidth - 10 
            && metrics.getHeight() < textFieldHeight - 4) {
            fontSize += 1f;
        } else {
            break;
        }
    }
    textField.setFont(textField.getFont().deriveFont(fontSize));
}

在文本框初始化时添加监听器：

textField.addComponentListener(new ComponentAdapter() {
    @Override
    public void componentResized(ComponentEvent e) {
        adjustTextFieldFont((JTextField) e.getComponent());
    }
});

完整修改后代码 #

package TestPackage;

import java.awt.*;
import java.awt.event.ComponentAdapter;
import java.awt.event.ComponentEvent;
import javax.swing.*;

public class TestGridLayout  {
    private static void adjustTextFieldFont(JTextField textField) {
        int textFieldWidth = textField.getWidth();
        int textFieldHeight = textField.getHeight();
        if (textFieldWidth <=0 || textFieldHeight <=0) return;
        float fontSize = 12f;
        Font tempFont;
        FontMetrics metrics;
        while (true) {
            tempFont = textField.getFont().deriveFont(fontSize + 1f);
            metrics = textField.getFontMetrics(tempFont);
            if (metrics.stringWidth(textField.getText()) < textFieldWidth - 10
                    && metrics.getHeight() < textFieldHeight - 4) {
                fontSize += 1f;
            } else {
                break;
            }
        }
        textField.setFont(textField.getFont().deriveFont(fontSize));
    }

    public static void main(String[] args) {
        JPanel testPanel = new JPanel(new GridBagLayout());
        GridBagConstraints gbc = new GridBagConstraints();
        // 固定组件间距
        gbc.insets = new Insets(4, 4, 4, 4);
        gbc.anchor = GridBagConstraints.WEST;

        String[] labelTexts = {"Label 1", "Label 2", "Label 3", "Label 4", "Label 5"};
        JTextField[] fields = new JTextField[labelTexts.length];

        for (int i = 0; i < labelTexts.length; i++) {
            // 添加标签
            gbc.gridx = 0;
            gbc.gridy = i;
            gbc.weightx = 0;
            gbc.fill = GridBagConstraints.NONE;
            testPanel.add(new JLabel(labelTexts[i]), gbc);

            // 添加文本框
            gbc.gridx = 1;
            gbc.weightx = 1.0;
            gbc.fill = GridBagConstraints.HORIZONTAL;
            fields[i] = new JTextField("input some data");
            // 添加字体自适应监听器
            fields[i].addComponentListener(new ComponentAdapter() {
                @Override
                public void componentResized(ComponentEvent e) {
                    adjustTextFieldFont((JTextField) e.getComponent());
                }
            });
            testPanel.add(fields[i], gbc);
        }

        JDialog dialog = new JDialog();
        // 表单放在NORTH位置，避免垂直拉伸
        dialog.add(testPanel, BorderLayout.NORTH);
        dialog.setSize(700,200);
        dialog.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
        dialog.setVisible(true);
        // 初始化触发一次字体适配
        for (JTextField field : fields) {
            adjustTextFieldFont(field);
        }
    }
}

其他可选方案 #

如果不需要文本框水平拉伸，还可以直接给原GridLayout的面板设置setMaximumSize，限制面板最大尺寸，超出部分作为窗口空白区域，也可以避免组件间距被撑大。

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