如何正确将QPushButton的clicked信号连接到pyqtSlot？

常见遗漏点及修复方式 #

1. 类继承与UI初始化错误 #

这是触发nullptr错误的核心原因，你的GUI类必须正确结合Qt基类与编译后的UI类：

• 错误写法：未继承Qt基类，或未正确初始化UI

class MyTool:  # 未继承QWidget/QMainWindow等Qt基类
    def __init__(self):
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)  # self不是Qt对象，初始化失败
        self.pushButton.clicked.connect(self.react_to_signal)  # self.pushButton不存在

• 正确写法1（多重继承）：

from PyQt5.QtWidgets import QMainWindow
from ui_mainwindow import Ui_MainWindow

class MyTool(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()  # 必须调用父类初始化
        self.setupUi(self)  # 将UI元素挂载到当前实例
        self.pushButton.clicked.connect(self.react_to_signal)

• 正确写法2（组合式）：

class MyTool(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        self.ui.pushButton.clicked.connect(self.react_to_signal)  # 必须通过self.ui访问控件

2. pyqtSlot与信号参数不匹配 #

QPushButton.clicked信号默认携带一个bool类型参数（表示按钮是否处于按下状态），如果slot参数不匹配，会触发TypeError：

• 错误写法：slot无参，但信号传递bool参数

@pyqtSlot()
def react_to_signal(self):
    print("Clicked")

• 修复方式：让slot参数与信号匹配，或指定信号重载版本

# 方式1：slot接收bool参数
@pyqtSlot(bool)
def react_to_signal(self, checked):
    print(f"Clicked, checked: {checked}")

# 方式2：使用无参的信号重载
self.pushButton.clicked[()].connect(self.react_to_signal)
@pyqtSlot()
def react_to_signal(self):
    print("Clicked")

3. 未启用Qt元对象系统 #

如果你的类未继承Qt的QObject子类（所有UI控件基类都继承自QObject），Qt无法识别@pyqtSlot装饰的方法，导致连接失效。确保你的GUI类继承自QWidget/QMainWindow/QDialog等Qt类。

与参考示例的核心差异 #

多数参考示例会严格遵循以下规则，而你可能遗漏了其中一项：

• 必须确保GUI类是Qt基类的子类，且正确调用super().__init__()完成初始化
• 严格按照UI类的加载方式引用控件（多重继承直接用self.控件名，组合式用self.ui.控件名）
• 保证@pyqtSlot的参数类型与信号参数完全匹配，或明确指定信号的重载版本

内容的提问来源于stack exchange，提问作者Евгений Крамаров