根据最大输入字符数计算JTextField宽度时尺寸偏小的原因是什么？

计算过程遗漏的核心因素 #

• 组件边框占用空间：JTextField的边框（Border）会在左右两侧占用像素宽度，你只计算了文本本身的宽度，未包含边框的占用空间，这是最主要的偏差来源。
• 文本与边框的预留边距：Swing文本组件默认设置了margin属性，即文本内容和边框之间的空白间隙，左右两侧的margin宽度需要计入总宽度。
• 光标预留空间：输入到最大字符数时，插入符（光标）需要占用1~2像素的宽度，未预留的话会导致最后一个字符被挤压、显示不全。
• 动态属性适配：你在组件构造阶段直接设置固定preferredSize，此时组件还未完成渲染，拿到的边距、字体渲染上下文可能不准确，且后续修改边框、字体、系统观感时，固定尺寸无法自动适配。

修正方案 #

覆写getPreferredSize方法动态计算宽度，把所有影响因素都纳入计算，适配所有场景，修正后的代码如下：

import java.awt.*;
import java.awt.font.*;
import java.awt.geom.*;
import javax.swing.*;

public class InputWidthTextField extends JFrame {

  public InputWidthTextField() {
    setSize(250, 230);
    setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
    setLocationRelativeTo(null);
    setLayout(new FlowLayout(FlowLayout.CENTER, 60, 20));
    Font font= new Font(Font.MONOSPACED, Font.PLAIN, 12);
    int max= 4;
    JLabel lb= new JLabel("Enter up to "+max+" characters:");
    add(lb);
    MaxInputWidthTextField tf= new MaxInputWidthTextField(font, max);
    add(tf);
    setVisible(true);
  }


  public static void main(String... args) {
    EventQueue.invokeLater(InputWidthTextField::new);
  }


  class MaxInputWidthTextField extends JTextField {
    private final int maxCharCount;

    public MaxInputWidthTextField(Font font, int maxCount) {
      super();
      this.maxCharCount = maxCount;
      if (font==null)
        font= getFont();
      else
        setFont(font);
    }    

    @Override
    public Dimension getPreferredSize() {
      Dimension baseSize = super.getPreferredSize();
      FontMetrics fm = getFontMetrics(getFont());
      // 使用最宽的字符'M'作为计算基准，适配非等宽字体场景
      String maxWidthStr = "M".repeat(maxCharCount);
      int textWidth = fm.stringWidth(maxWidthStr);

      // 叠加边框、边距宽度
      Insets borderInsets = getInsets();
      Insets contentMargin = getMargin();
      int totalWidth = textWidth + borderInsets.left + borderInsets.right 
                      + contentMargin.left + contentMargin.right;
      // 额外预留2像素给光标
      totalWidth += 2;

      return new Dimension(totalWidth, baseSize.height);
    }
  }
}

补充说明 #

JTextField(int columns)构造方法的列宽计算依赖当前系统观感的默认实现，部分L&F实现时未完整考虑边距和光标预留空间，因此也会出现容纳不下最大字符数的问题。

内容的提问来源于stack exchange，提问作者Jörg