Java Swing中JPanel添加自定义Carta组件后无法显示问题排查

自定义卡牌类Carta单独测试paintComponent正常，但加入项目JPanel后无法显示，核心是违反了Swing组件的绘制与布局规则，对应问题和修复方式如下：

原有实现代码 #

Carta类重写的绘制方法：

@Override
public void paintComponent(Graphics g) {
    Graphics2D g2d = (Graphics2D) g;
    RoundRectangle2D rect2 = new RoundRectangle2D.Double(posicio.x + CARD_WIDTH + 20,
                                                         (posicio.y * CARD_HEIGHT) + 10,
                                                         CARD_WIDTH,
                                                         CARD_HEIGHT,
                                                         CORNER_ANGLE,
                                                         CORNER_ANGLE);
    g2d.setColor(Color.WHITE);
    g2d.fill(rect2);
    g2d.setColor(Color.black);
    g2d.draw(rect2);
    BufferedImage imatge = null;
    if (caraAmunt) {
        try {
            imatge = ImageIO.read(new File(cami));
        } catch (IOException ex) {
            Logger.getLogger(Carta.class.getName()).log(Level.SEVERE, null, ex);
        }
    } else {
        try {
            imatge = ImageIO.read(new File(camiDefecte));
        } catch (IOException ex) {
            Logger.getLogger(Carta.class.getName()).log(Level.SEVERE, null, ex);
        }
    }
    g.drawImage(imatge.getScaledInstance(CARD_WIDTH, CARD_HEIGHT, Image.SCALE_SMOOTH),
                posicio.x + CARD_WIDTH + 20,
                (posicio.y * CARD_HEIGHT) + 10,
                null);
}

当前调用代码：

Carta foo = new Carta(SPADES, ACE, new Point(0, 0), true);
this.add(foo);

修复点 #

• 必须在paintComponent方法第一行调用父类绘制方法：super.paintComponent(g);，否则会出现背景不绘制、脏像素残留、组件渲染异常等问题。
• 修正绘制坐标逻辑：paintComponent使用的是组件自身的相对坐标系，组件左上角固定为坐标原点(0,0)，不需要在绘制坐标里叠加posicio的父容器位置，额外加posicio.x + CARD_WIDTH + 20这类偏移会把卡牌内容直接画到组件自身可视区域之外，看起来就是完全不显示。绘制圆角矩形、图片时直接基于组件自身尺寸计算坐标即可。
• 给自定义组件返回正确的preferred尺寸：Swing布局管理器依赖组件的getPreferredSize()返回值计算布局大小，默认该方法返回0x0的尺寸，组件会被判定为不需要占用空间自然不会显示。你需要在Carta类中重写该方法，返回卡牌实际的宽高：

  @Override
  public Dimension getPreferredSize() {
      return new Dimension(CARD_WIDTH, CARD_HEIGHT);
  }
  

  如果你使用绝对定位（null布局）放置卡牌，需要手动给每个Carta组件调用setBounds(x, y, width, height)设置位置和尺寸，否则组件默认边界为0x0，不会被渲染。
• 不要在paintComponent中做IO读取操作：paintComponent会被系统频繁触发（窗口移动、缩放、其他组件遮挡移开都会触发重绘），每次绘制都读取本地图片会造成严重的界面卡顿，甚至IO异常导致图片对象为null触发空指针。你应该在Carta的构造方法中一次性读取正面、背面卡牌图片，缓存为类成员变量，绘制时直接使用缓存的图片对象即可，同时要加图片非空判断，避免空指针崩溃。
• 动态添加组件后触发布局刷新：如果是在窗口已经显示后再往JPanel里加卡牌，添加完成后需要调用父容器的revalidate()触发布局重新计算，再调用repaint()触发重绘，否则新加的组件不会被渲染到界面上。
• 检查容器布局逻辑：如果你直接把卡牌组件add到JFrame的内容面板，默认是BorderLayout，不指定布局约束的话所有组件会堆叠在中心区域互相覆盖。建议专门用一个JPanel作为卡牌容器，根据你要的堆叠/排列效果选择合适的布局，或者自定义布局管理器统一管理卡牌位置，不要混用绝对定位和自带布局管理器。

额外提示：如果使用Image.SCALE_SMOOTH缩放图片，建议提前在加载图片时就完成缩放缓存，不要在绘制时每次调用getScaledInstance，该方法是异步执行的，会导致绘制时图片还没加载完成出现闪烁。

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