PyQt5中使用clicked.connect绑定按钮事件时.connect无法被IDE识别

在PyQt5开发过程中，尝试通过clicked.connect方法为按钮添加点击触发动作时遇到两类问题：

• 编码阶段IDE可以正常识别clicked属性，但输入.connect时，IDE不会提示该可用命令
• 代码逻辑存在潜在运行错误
  相关问题代码如下：

import PyQt5.QtWidgets as qtwidget
import PyQt5.QtGui as qtgui
import PyQt5.QtCore as qtcore


app = qtwidget.QApplication([])
class Button(qtwidget.QPushButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent=parent)
        button_policy = self.sizePolicy()
        button_policy.setVerticalPolicy(button_policy.Policy.Minimum)
        self.setSizePolicy(button_policy)
        
        # Set text font style & size
        self.setFont(qtgui.QFont('Helvetica', 20))
        
        
        self.clicked.connect(self.update_label) # connect does not seem to be recognized
        
    def update_label(self, text, target):
        target.setText(text)

问题截图：

1. IDE无connect补全提示：PyQt5是Qt C++框架的Python绑定，信号相关方法没有原生Python类型签名，默认情况下静态代码分析工具无法识别这类动态生成的方法，属于IDE类型识别的兼容问题，不代表代码语法错误。
2. 代码潜在运行错误：QPushButton的clicked信号触发时，仅会传递1个布尔类型的参数（代表按钮是否为选中状态），和定义的update_label需要的text、target两个参数不匹配，直接运行会抛出参数数量不匹配的异常。

解决IDE补全问题 #

安装PyQt5对应的类型提示桩文件即可，执行以下命令后重启IDE：

pip install PyQt5-stubs

安装完成后IDE就可以正常识别信号的connect、disconnect等方法，提供正常补全和类型检查。

修复代码逻辑错误 #

根据业务场景二选一即可：

• 场景1：按钮固定关联一个需要更新的标签，直接在初始化时传入目标标签作为实例属性

import PyQt5.QtWidgets as qtwidget
import PyQt5.QtGui as qtgui
import PyQt5.QtCore as qtcore


app = qtwidget.QApplication([])
class Button(qtwidget.QPushButton):
    def __init__(self, text, target_label=None, parent=None):
        super().__init__(text, parent=parent)
        # 持有目标标签的引用
        self.target_label = target_label
        button_policy = self.sizePolicy()
        button_policy.setVerticalPolicy(button_policy.Policy.Minimum)
        self.setSizePolicy(button_policy)
        
        # Set text font style & size
        self.setFont(qtgui.QFont('Helvetica', 20))
        
        self.clicked.connect(self.update_label)
        
    def update_label(self, checked=False):
        # 信号默认传的checked参数不需要使用的话留占位即可
        if self.target_label:
            self.target_label.setText(self.text())

• 场景2：绑定时需要动态传入自定义参数，用lambda做一层包装

# 初始化按钮后绑定信号时，通过lambda传入自定义参数，注意预留checked参数位
target_label = qtwidget.QLabel()
btn = Button("测试按钮")
btn.clicked.connect(lambda checked: btn.update_label("自定义显示文本", target_label))

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