QScrollArea设置透明背景与边框 圆角渐变白边问题

QScrollArea是复合控件，除了你手动添加的widget_panel内容容器，还自带外层容器、内置viewport视口两层子控件，默认会跟随Fusion风格绘制灰色/白色底色：

• 仅给内容控件设置透明时，实际会穿透显示到下层viewport的默认底色，不会透到最外层
• 加border-radius后圆角外的区域属于控件非绘制区，如果没有开启控件透明属性，就会默认填充白色
• 滚动区默认自带的边框也会额外占像素，干扰圆角显示

按以下顺序修改即可实现无白边、带圆角的渐变面板效果：

• 先移除QScrollArea默认自带的边框
• 给QScrollArea和它的内置viewport都设置透明背景，消除默认风格底色
• 保留原有内容面板的渐变+圆角样式，给内容面板开启WA_TranslucentBackground属性，让圆角外区域真正透明
• 可选：自定义滚动条样式适配整体风格

class MainMenu(QtWidgets.QMainWindow):
    def __init__(self, playflash):
        QtWidgets.QMainWindow.__init__(self)

        # [...] 你的原有初始化代码

        # 1. 移除滚动区默认边框
        self.scroll_panel.setFrameShape(QtWidgets.QFrame.NoFrame)
        # 2. 给内容面板开启透明属性，保证圆角外区域不填充白色
        self.widget_panel.setAttribute(QtCore.Qt.WA_TranslucentBackground)
        self.widget_panel.setProperty("class", "qwidget-special")
        
        # 3. 补全滚动区、viewport的透明样式，保留原有渐变样式
        self.special_style = """
                QScrollArea {
                    background: transparent;
                    border: none;
                }
                QScrollArea .viewport {
                    background: transparent;
                    border: none;
                }
                .qwidget-special
                {
                    background: qlineargradient(spread:pad, x1:0.505, y1:0.0797273, x2:0.51, y2:0.920455, stop:0 rgba(112, 98, 174, 255), stop:1 rgba(224, 205, 255, 255));
                    border-radius: 18px;
                    border: none;
                }
                /* 可选：自定义滚动条样式，不需要可以删除 */
                QScrollBar:vertical {
                    background: transparent;
                    width: 8px;
                    border-radius: 4px;
                    margin: 16px 4px;
                }
                QScrollBar::handle:vertical {
                    background: rgba(255, 255, 255, 120);
                    border-radius: 4px;
                    min-height: 24px;
                }
                QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical,
                QScrollBar::add-page:vertical, QScrollBar::sub-page:vertical {
                    background: transparent;
                    height: 0;
                }
                """
        # 注意：样式要设置给scroll_panel，不要只设置给widget_panel
        self.scroll_panel.setStyleSheet(self.special_style)

        # [...] 你的后续布局代码

不要直接给.qwidget-special设置background: transparent，否则你需要的渐变填充也会被透掉。WA_TranslucentBackground属性只会让控件没有绘制内容的区域（也就是圆角外侧）透明，你写的渐变背景会正常在圆角范围内绘制。
如果调整后还有极细白边，可以给.qwidget-special加1px和渐变边缘同色的边框，或者把border-radius值微调1-2px即可消除。

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