在 PyQt5 中，直接对 QScrollArea 应用 setStyleSheet() 无法改变其可视区域（viewport）的背景色；必须单独设置其 viewport() 的样式表才能实现每个滚动区域颜色各异的效果。
在 pyqt5 中，直接对 qscrollarea 应用 `setstylesheet()` 无法改变其可视区域（viewport）的背景色；必须单独设置其 `viewport()` 的样式表才能实现每个滚动区域颜色各异的效果。
QScrollArea 是一个复合控件：它本身仅负责管理滚动条和布局逻辑，真正显示内容的是其内部的 viewport（视口） —— 一个继承自 QAbstractScrollArea 的私有子部件。因此，即使你为 QScrollArea 设置了 background-color，该样式默认不会作用于 viewport，导致视觉上“颜色未生效”。
✅ 正确做法是：
- 先为 QScrollArea 设置边框、圆角等装饰性样式（不包含背景色）；
- 再单独调用 scroll_area.viewport().setStyleSheet(...) 设置 viewport 的背景色。
以下是完整可运行示例，创建三个颜色各异的 QScrollArea：
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QScrollArea, QVBoxLayout, QLabel, QGridLayout
from PyQt5.QtCore import Qt
import sys
class MainWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setupUi()
def setupUi(self):
self.setWindowTitle("Multi-Color Scroll Areas")
self.setGeometry(100, 100, 1024, 768)
self.setStyleSheet("background-color: #19191A;")
# Scroll Area 1 — Dark Gray
scroll_area_1 = QScrollArea(self)
scroll_area_1.setGeometry(80, 80, 260, 520)
scroll_area_1.setWidgetResizable(True)
scroll_area_1.viewport().setStyleSheet("background-color: #201F22;")
scroll_area_1.setStyleSheet("border: 1px solid #3a3a3c; border-radius: 12px;")
content_1 = QWidget()
layout_1 = QVBoxLayout(content_1)
layout_1.addWidget(QLabel("? Section A", alignment=Qt.AlignCenter))
layout_1.addWidget(QLabel("• Item 1", alignment=Qt.AlignLeft))
layout_1.addWidget(QLabel("• Item 2", alignment=Qt.AlignLeft))
layout_1.addStretch()
scroll_area_1.setWidget(content_1)
# Scroll Area 2 — Deep Blue
scroll_area_2 = QScrollArea(self)
scroll_area_2.setGeometry(380, 80, 260, 520)
scroll_area_2.setWidgetResizable(True)
scroll_area_2.viewport().setStyleSheet("background-color: #1a233a;")
scroll_area_2.setStyleSheet("border: 1px solid #2a3a5a; border-radius: 12px;")
content_2 = QWidget()
layout_2 = QVBoxLayout(content_2)
layout_2.addWidget(QLabel("? Section B", alignment=Qt.AlignCenter))
layout_2.addWidget(QLabel("• Filter 1", alignment=Qt.AlignLeft))
layout_2.addWidget(QLabel("• Filter 2", alignment=Qt.AlignLeft))
layout_2.addStretch()
scroll_area_2.setWidget(content_2)
# Scroll Area 3 — Charcoal Green
scroll_area_3 = QScrollArea(self)
scroll_area_3.setGeometry(680, 80, 260, 520)
scroll_area_3.setWidgetResizable(True)
scroll_area_3.viewport().setStyleSheet("background-color: #1e2b22;")
scroll_area_3.setStyleSheet("border: 1px solid #2e3b32; border-radius: 12px;")
content_3 = QWidget()
layout_3 = QVBoxLayout(content_3)
layout_3.addWidget(QLabel("? Section C", alignment=Qt.AlignCenter))
layout_3.addWidget(QLabel("• Chart 1", alignment=Qt.AlignLeft))
layout_3.addWidget(QLabel("• Chart 2", alignment=Qt.AlignLeft))
layout_3.addStretch()
scroll_area_3.setWidget(content_3)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())⚠️ 注意事项：
- viewport() 必须在 setWidget() 之前或之后调用均可，但务必确保 QScrollArea 已完成初始化（即不能在 setWidget() 前访问未创建的 viewport）；
- 若启用 setWidgetResizable(True)，viewport 会自动适配内容尺寸，此时背景色将随滚动区域内容区动态填充；
- 避免对 QScrollArea 和 viewport 同时设置 background-color，否则可能产生覆盖或闪烁；
- 如需更精细控制（如渐变、图片背景），可继承 QGraphicsView 或重写 paintEvent，但对多数 UI 场景，viewport().setStyleSheet() 已足够高效且简洁。
通过此方法，你可以轻松为每个 QScrollArea 独立定制视觉风格，显著提升 PyQt5 应用的界面层次感与专业度。
