Java Swing：重写JList.paint方法绘制空状态居中JLabel时标签被截断

你的截断问题本质上是几个Swing绘制逻辑的细节叠加导致的：

• 人为设置的裁剪矩形过窄：你在调用g.create(x, y, preferredSize.width, preferredSize.height)时，方法会自动把这个矩形设为图形上下文的新裁剪边界。而你用来计算裁剪宽度的preferredSize，是从未参与过实际布局的独立JLabel实例计算出来的值——因为这个JLabel从来没被添加到任何容器、没完成过和当前DPI、字体渲染的适配，计算出的preferredSize往往比文本实际需要的宽度小几像素，刚好把文本边缘裁掉。你调大裁剪宽度就正常，也印证了这一点。
• 组件渲染状态不同步：JLabel在paint方法里会根据当前自身的bounds宽度，触发BasicLabelUI的内部布局逻辑——如果发现传入的bounds宽度刚好卡着文本测量值，UI会自动开启文本截断逻辑（加省略号），进一步加剧截断问题。
• 边界坐标计算的隐患：当标签实际需要的宽度大于JList本身的宽度时，你计算出的居中x坐标会是负数，这时候负坐标的绘制内容会被JList本身的组件裁剪边界切掉，进一步出现内容缺失。

这种在paint方法里手动绘制JLabel做空状态的方案是可运行但不够规范的：

• 优势：实现成本低，不需要修改组件层级，没有额外的布局开销，适合做简单的静态空状态提示。
• 缺陷：
  • 因为是手动模拟组件绘制流程，Swing组件的很多内置逻辑（比如字体适配、DPI缩放、文本换行、截断处理）都需要你自己手动对齐，很容易出现状态不同步的bug。
  • 如果你后续需要给空状态加交互（比如提示里带可点击的链接、按钮），这种手动绘制的方式根本没法处理鼠标事件、焦点事件。
  • 长文本场景下的适配成本很高，比如需要文本自动换行、根据JList宽度调整字号的时候，你得手动写很多测量逻辑。

最小改动的现有逻辑修复 #

如果想保留现有手动绘制的实现，只需要调整两个细节就能解决截断问题：

1. 不要用和preferredSize等宽的自定义裁剪矩形，直接平移图形上下文，沿用JList本身的组件裁剪边界，避免人为设置过窄的裁剪框。
2. 给空标签设置最大宽度约束，避免标签的布局宽度超出JList的可视范围，减少负坐标的绘制问题。
   修复后的核心代码片段：

@Override
protected void paintComponent(final Graphics g) {
    super.paintComponent(g);
    if (getModel().getSize() > 0) return;

    final int listWidth = getWidth();
    // 限制标签最大宽度不超过JList宽度，避免无约束布局导致的坐标异常
    emptyLabel.setMaximumSize(new Dimension(listWidth, Integer.MAX_VALUE));
    final Dimension labelSize = emptyLabel.getPreferredSize();

    final int x = (listWidth - labelSize.width) / 2;
    final int y = (getHeight() - labelSize.height) / 2;

    final Graphics2D g2 = (Graphics2D) g.create();
    try {
        g2.translate(x, y);
        emptyLabel.setBounds(0, 0, labelSize.width, labelSize.height);
        emptyLabel.paint(g2);
    } finally {
        g2.dispose();
    }
}

更符合Swing规范的实现方式 #

如果不需要严格保持组件层级不变，可以直接把emptyLabel作为JList的透明子组件添加进去，重写布局逻辑：当列表为空时把标签居中并显示，当列表有内容时把标签隐藏。这种方式下标签完全走Swing正常的布局、渲染、事件流程，不会出现截断、状态不同步的问题，后续要加交互元素也很方便。

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