Java Swing 背景圖片導致 JLabel 不可見、按鈕需滑鼠懸停才顯示的排查方案

常見原因分析

1. 繪製順序錯誤：在 paintComponent 中繪製背景圖片後未調用 super.paintComponent(g)，導致子組件 (JLabel、JButton) 未被正常繪製。
2. 佈局管理器失效：使用 null 佈局 (絕對定位) 但未正確設定組件 bounds，或背景面板未設定 setOpaque(false) 導致遮擋。
3. 組件透明度設定：JLabel 預設不透明，需 setOpaque(false) 才能顯示背景圖片上的文字。

標準解決模式：繼承 JPanel 重寫 paintComponent

class BackgroundPanel extends JPanel {
    private Image bgImage;
    public BackgroundPanel(String imgPath) {
        bgImage = new ImageIcon(imgPath).getImage();
        setOpaque(false); // 關鍵：讓面板透明，不遮擋背景
        setLayout(new FlowLayout()); // 或其他佈局
    }
    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // 必須第一行調用，確保子組件正常繪製
        if (bgImage != null) {
            g.drawImage(bgImage, 0, 0, getWidth(), getHeight(), this);
        }
    }
}

// 使用方式
JFrame frame = new JFrame();
BackgroundPanel panel = new BackgroundPanel("bg.jpg");
panel.add(new JLabel("標籤文字")); // 需 label.setOpaque(false)
panel.add(new JButton("按鈕"));
frame.setContentPane(panel);

按鈕需懸停才顯示的特殊原因

通常是因為按鈕邊框/背景繪製異常，嘗試：

• button.setContentAreaFilled(false) 關閉預設填充。
• button.setFocusPainted(false) 關閉焦點邊框。
• 檢查是否有自定義 UI/看與感 干擾。

參考資源

百度知道相關討論：Java Swing 背景圖片顯示問題解決