Qt Widget 背景圖片無法顯示？教你用 Stylesheet 輕鬆解決

問題背景

在使用 Qt Widget 開發佈局管理的小程式時，介面主要由 QListWidget 和 QStackedWidget 組成。嘗試按照網上常見方法設定背景圖片，卻發現圖片無法顯示，背景呈現純黑色。雖然背景顏色可以正常設定，但背景圖片始終不生效。

解決方案：使用 Stylesheet 設定背景

經測試，在 Qt 5.5 環境下，最直接有效的方法是通過 Stylesheet（樣式表） 來實現背景圖片的設置。具體操作步驟如下：

1. 在 Qt Designer 中右鍵點擊目標 Widget（或主視窗）。
2. 選擇「改變樣式表」（Change styleSheet）。
3. 在彈出的編輯器中，點擊「添加資源」（Add Resource），選擇事先準備好的圖片檔案（需先加入 .qrc 資源檔）。
4. 樣式表會自動生成類似 background-image: url(:/images/bg.png); 的規則，確認後應用即可。

關鍵點提醒

• 圖片必須通過 Qt 資源系統（.qrc）引入，絕對路徑在部署時易失效。
• 若 Widget 佈局複雜，建議在頂層容器（如主視窗或中央 Widget）設定背景，避免子元件遮蓋。
• 若仍顯示黑色，檢查圖片格式是否支援（推薦 PNG），以及資源路徑是否正確。

採用 Stylesheet 方式不僅解決了背景圖片顯示問題，還能統一管理介面樣式，是 Qt 開發中推薦的最佳實踐。