PyQt5中不依赖setStyleSheet绘制圆形按钮的替代方法

除了QSS样式表的实现方式，你可以用以下三种原生Qt方案实现完全一致的圆形按钮效果，不需要依赖样式表定义属性：

方案1：重写paintEvent全自绘 #

这是自由度最高的实现方式，直接通过QPainter在按钮绘制事件中手动绘制圆形背景、边框、文字，所有属性（颜色、边框粗细、圆角大小）都可以作为类属性直接定义，完全不依赖样式表。
示例代码：

from PyQt5.QtWidgets import QPushButton
from PyQt5.QtGui import QPainter, QColor, QPen, QBrush
from PyQt5.QtCore import Qt, QSize

class CircleButton(QPushButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent)
        self.setFixedSize(QSize(50, 50))
        # 直接定义样式属性，无需写QSS
        self.border_color = QColor(0, 0, 0)    # 黑色边框
        self.bg_color = QColor(0, 128, 0)      # 绿色背景
        self.text_color = QColor(255, 255, 0)  # 黄色文字
        self.border_width = 1
        self.radius = 25

    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)  # 开抗锯齿避免边缘毛边
        # 绘制圆形背景
        painter.setBrush(QBrush(self.bg_color))
        painter.setPen(QPen(self.border_color, self.border_width))
        # 绘制时预留边框宽度，避免边框被控件边缘切掉一半
        draw_rect = self.rect().adjusted(
            self.border_width//2, self.border_width//2,
            -self.border_width//2, -self.border_width//2
        )
        painter.drawEllipse(draw_rect)
        # 居中绘制按钮文字
        painter.setPen(self.text_color)
        painter.drawText(self.rect(), Qt.AlignCenter, self.text())

使用时直接替换循环里的QPushButton为CircleButton即可，不需要调用setStyleSheet。

方案2：QPalette配置颜色 + QRegion裁剪 #

这个方案不需要自定义按钮类，代码量最小：通过QPalette设置按钮的背景、文字颜色，再通过setMask直接把控件的可见、可点击区域裁剪为正圆形，方形区域会被完全隐藏，不会响应点击。
示例代码：

from PyQt5.QtGui import QRegion, QPalette, QColor
from PyQt5.QtCore import Qt

# 原有循环逻辑修改如下
self.button_list = []
for i in range(10):
    button = QPushButton("{}".format(i+1), self)
    button.setFixedSize(QSize(50, 50))
    button.setFlat(True)  # 关闭按钮默认的方形立体边框
    # 通过调色板设置颜色
    pal = button.palette()
    pal.setColor(QPalette.Button, QColor(0, 128, 0))     # 绿色背景
    pal.setColor(QPalette.ButtonText, QColor(255,255,0)) # 黄色文字
    button.setPalette(pal)
    button.setAutoFillBackground(True)  # 必须开启，否则调色板背景色不生效
    # 将控件裁剪为正圆形
    button.setMask(QRegion(button.rect(), QRegion.Ellipse))

    self.button_list.append(button)
    mainlayout.addWidget(button, i)

如果需要加1px黑色边框，只需要给按钮加一个简单的paintEvent绘制椭圆边框即可，不需要额外嵌套控件。

方案3：QStyle原生绘制 + 路径裁剪 #

这个方案平衡了开发量和原生体验：不需要手动处理按钮的悬停、点击、禁用等交互状态，调用Qt内置的QStyle接口绘制默认按钮逻辑，只需要把绘制区域裁剪为圆形、替换对应颜色即可，能保留原生按钮的所有交互反馈。
示例代码：

from PyQt5.QtWidgets import QPushButton, QStyleOptionButton
from PyQt5.QtGui import QPainter, QColor, QPen, QPainterPath
from PyQt5.QtCore import QSize

class NativeStyleCircleButton(QPushButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent)
        self.setFixedSize(QSize(50,50))

    def paintEvent(self, event):
        opt = QStyleOptionButton()
        self.initStyleOption(opt)
        # 替换需要的颜色
        opt.palette.setColor(QPalette.Button, QColor(0,128,0))
        opt.palette.setColor(QPalette.ButtonText, QColor(255,255,0))

        painter = QPainter(self)
        painter.setRenderHint(QPainter.Antialiasing)
        # 裁剪绘制区域为圆形
        circle_path = QPainterPath()
        circle_path.addEllipse(self.rect().adjusted(1,1,-1,-1))
        painter.setClipPath(circle_path)
        # 调用Qt原生逻辑绘制按钮，自动处理按下/悬停等状态
        self.style().drawControl(QStyle.CE_PushButton, opt, painter, self)
        # 绘制1px黑色边框
        painter.setClipping(False)
        painter.setPen(QPen(QColor(0,0,0), 1))
        painter.drawEllipse(self.rect().adjusted(0,0,-1,-1))

方案选型参考 #

• 需要高度自定义外观（比如加渐变、点击动效、自定义图标位置）选方案1
• 只是需要基础圆形按钮、不想写自定义类选方案2
• 需要保留原生按钮的交互反馈、减少自绘代码量选方案3

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