如何在PyQt5中正确子类化QLabel实现自定义样式标签功能

存在的核心问题 #

• 自定义MyLabel类初始化时接收了文本参数，但未赋值给标签本身，导致无内容显示
• 字体名参数额外包裹了双引号，导致QFont无法识别对应字体
• 尺寸设置逻辑冲突：setFixedSize()后调用adjustSize()会覆盖固定尺寸设置；传入的字重值60远低于常规字重标准（常规字重为400，粗体为700），会导致文字过细
• 类属性mylabel_fontname存在拼写错误，后续调用该属性会触发异常

修复后完整代码 #

import sys
from PyQt5.QtWidgets import QWidget, QApplication, QLabel, QVBoxLayout
from PyQt5.QtGui import QFont

class MyLabel(QLabel):
    def __init__(self, mylabel_text, mylabel_fontname, mylabel_fontsize, mylabel_fontweight, parent=None):
        super().__init__(parent)
        # 修复属性拼写错误
        self.mylabel_fontname = mylabel_fontname
        self.mylabel_fontsize = mylabel_fontsize
        self.mylabel_fontweight = mylabel_fontweight
        
        font = QFont()
        # 直接传入字体名，不需要额外加双引号
        font.setFamily(self.mylabel_fontname)
        font.setPointSize(self.mylabel_fontsize)
        font.setWeight(self.mylabel_fontweight)
        self.setFont(font)
        # 新增：给标签设置传入的文本，兼容富文本语法
        self.setText(mylabel_text)

class example(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My Widget Example")

        # 字重调整为600（半粗体），符合常规使用标准
        self.lbl1 = MyLabel(mylabel_text='<font color="green"><u>自定义标签</u></font>测试', mylabel_fontname="Trebuchet MS", mylabel_fontsize=14,
                            mylabel_fontweight=600)
        # 二选一：需要固定大小就删除adjustSize，需要自适应就删除setFixedSize
        self.lbl1.setFixedSize(600, 100)
        # self.lbl1.adjustSize()
        self.lbl2 = QLabel('<font color="red"><u>F</u></font><font color="black">ile</font>')
        self.lbl2.setFixedSize(600, 100)
        # self.lbl2.adjustSize()
        self.vbox = QVBoxLayout()
        self.vbox.addWidget(self.lbl1)
        self.vbox.addWidget(self.lbl2)
        self.setLayout(self.vbox)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    mainwindow = example()
    mainwindow.show()
    sys.exit(app.exec_())

修改说明 #

1. 修复自定义类中mylabel_fontname属性的拼写错误，避免后续调用该属性时报错
2. 新增self.setText(mylabel_text)逻辑，让自定义标签可以正常显示传入的文本，同时完美兼容原生QLabel的富文本语法
3. 移除给字体名额外添加的双引号，保证QFont可以正常识别加载指定字体
4. 调整字重参数为符合标准的合理值，同时优化尺寸设置逻辑，避免固定尺寸和自适应尺寸的冲突

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