Java Swing游戏场景切换时JButton仅Hover后显示问题求助

问题背景 #

• 基于Java开发简单游戏，核心组件结构：
  • 单例SceneManager类：采用CardLayout控制场景的显示与切换
  • Scene父类：所有场景的模板类，通过线程实现游戏循环以支持动画效果
  • 具体场景实现：MainMenuScene（主菜单场景）、GameScene（游戏运行场景）

问题现象 #

• 程序启动后，主菜单中的JButton默认处于不可见状态，仅当鼠标悬浮在按钮区域时才会显示
• 调用resume()方法后，鼠标悬浮时按钮出现闪烁现象：触碰瞬间显示，下一帧立即消失，需再次移动鼠标才会重新显示

已尝试操作 #

• 将主菜单的布局直接设置为SceneManager的CardLayout：按钮可正常显示，但会占满整个窗口，不符合布局需求
• 在代码多处添加revalidate()方法调用：未解决任何问题

排查方向与解决建议 #

1. 解决线程游戏循环与Swing EDT的冲突 #

Swing的UI操作必须在**事件调度线程（EDT）**中执行，你的Scene父类通过独立线程运行游戏循环，如果在非EDT线程中进行UI更新（比如添加按钮、修改组件可见性、调整布局），会直接导致UI渲染异常，出现按钮不显示、闪烁等问题。

• 修正方案：所有涉及Swing组件的操作，必须用SwingUtilities.invokeLater()或SwingUtilities.invokeAndWait()包裹，确保在EDT中执行。示例代码：

SwingUtilities.invokeLater(() -> {
    // 示例：向主菜单面板添加按钮
    mainMenuPanel.add(startGameBtn);
    mainMenuPanel.repaint();
});

2. 调整CardLayout的使用方式 #

• 不要直接将场景的布局设置为SceneManager的CardLayout，应该让每个Scene拥有自己的独立布局（比如FlowLayout、BorderLayout），再将整个场景的面板作为卡片添加到SceneManager的CardLayout容器中。这样既保证了场景内部的布局独立性，也避免了组件被强制拉伸占满窗口的问题。
• 检查SceneManager添加场景时的逻辑，确保MainMenuScene对应的面板被正确添加，且未被意外设置为setVisible(false)。

3. 优化游戏循环的刷新逻辑 #

如果游戏循环中每帧都调用repaint()刷新整个面板，会覆盖Swing自身的UI状态渲染（比如按钮的hover状态），导致按钮闪烁。

• 优化方案：仅当场景中的动画元素（比如游戏角色、特效）需要更新时，才调用repaint()；或者调用repaint(Rectangle)指定具体的刷新区域，避免刷新UI组件所在的区域。

4. 检查组件的不透明性设置 #

• 确保按钮所在的面板设置了setOpaque(true)，透明面板会导致组件背景渲染异常，间接引发显示问题。
• 检查JButton的不透明性：如果自定义了按钮UI，确认未将按钮设置为透明，默认JButton的setOpaque(true)是开启状态，可保证正常显示。

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