循环实例化PyQt控件时如何在connect中正确使用lambda函数传参

问题根源 #

这是Python闭包晚绑定特性导致的典型问题：

• 循环内定义的lambda不会在定义阶段捕获widgetNumber的即时值，只会在信号触发、lambda实际执行时才查找该变量的值。此时循环早已执行完毕，widgetNumber固定为最后一轮迭代的取值，因此所有控件触发信号都会拿到错误的末尾索引。
• 改写为lambda widgetNumber: self.argumentChanged(...)后逻辑错误的原因是：PyQt信号触发时会自动将信号携带的参数按顺序传入槽函数，QSpinBox的valueChanged信号传出的参数就是控件当前的新值，QCheckBox的stateChanged会传出勾选状态值，因此形参widgetNumber实际接收到的是信号传出的参数，而非循环索引，才会出现数值调整、索引同步变化的异常。

修复方案 #

方案1：通过lambda默认参数固定循环即时值 #

Python函数的默认参数在函数定义阶段就会完成求值，利用这个特性可以在绑定信号时就固定住当次循环的索引和控件实例，避免晚绑定问题。
修正后的完整代码：

from PyQt5.QtWidgets import QApplication, QVBoxLayout, QCheckBox, QSpinBox, QWidget
import sys

class MyWidget(QWidget):
    def __init__(self, widgetList):
        super().__init__()
        self.widgetList = widgetList
        layout = QVBoxLayout()
        
        for widgetNumber in range(len(widgetList)):
            widget_type = widgetList[widgetNumber]
            if widget_type == 'QCheckBox':
                widget = QCheckBox()
                # 用默认参数固定当前索引和控件实例，第一个形参接收信号传出的状态值
                widget.stateChanged.connect(
                    lambda state, num=widgetNumber, w=widget: self.argumentChanged(num, w.isChecked())
                )
            elif widget_type == 'QSpinBox':
                widget = QSpinBox()
                # 第一个形参接收信号传出的数值，默认参数固定索引和控件实例
                widget.valueChanged.connect(
                    lambda val, num=widgetNumber, w=widget: self.argumentChanged(num, w.value())
                )
            layout.addWidget(widget)
            
        self.setLayout(layout)
    
    def argumentChanged(self, widgetNumber, value):
        print("The widget number", widgetNumber, "that is a", self.widgetList[widgetNumber], "has been modified! New value:", value)
    
def window():
    app = QApplication(sys.argv)
    widgetList = ['QCheckBox', 'QCheckBox', 'QSpinBox']
    widget = MyWidget(widgetList)
    widget.show()
    sys.exit(app.exec_())
    
if __name__ == '__main__':
    window()

方案2：利用控件自定义属性 + sender()方法获取触发源 #

给每个动态生成的控件绑定自定义属性存储索引，信号触发时通过PyQt内置的sender()方法拿到当前触发信号的控件实例，直接读取存储的索引即可，这种写法不需要处理信号传参和lambda闭包的问题，逻辑更稳定：

from PyQt5.QtWidgets import QApplication, QVBoxLayout, QCheckBox, QSpinBox, QWidget
import sys

class MyWidget(QWidget):
    def __init__(self, widgetList):
        super().__init__()
        self.widgetList = widgetList
        layout = QVBoxLayout()
        
        for widgetNumber in range(len(widgetList)):
            widget_type = widgetList[widgetNumber]
            if widget_type == 'QCheckBox':
                widget = QCheckBox()
                widget.idx = widgetNumber  # 自定义属性存储索引
                widget.stateChanged.connect(self.argumentChanged)
            elif widget_type == 'QSpinBox':
                widget = QSpinBox()
                widget.idx = widgetNumber  # 自定义属性存储索引
                widget.valueChanged.connect(self.argumentChanged)
            layout.addWidget(widget)
            
        self.setLayout(layout)
    
    def argumentChanged(self, *args):
        # 获取触发当前信号的控件实例
        widget = self.sender()
        widgetNumber = widget.idx
        # 按控件类型读取当前值
        if isinstance(widget, QCheckBox):
            value = widget.isChecked()
        elif isinstance(widget, QSpinBox):
            value = widget.value()
        print("The widget number", widgetNumber, "that is a", self.widgetList[widgetNumber], "has been modified! New value:", value)
    
def window():
    app = QApplication(sys.argv)
    widgetList = ['QCheckBox', 'QCheckBox', 'QSpinBox']
    widget = MyWidget(widgetList)
    widget.show()
    sys.exit(app.exec_())
    
if __name__ == '__main__':
    window()

注意事项 #

• 所有循环内定义槽函数、需要引用循环变量的场景，都需要留意Python闭包晚绑定的特性，避免出现变量取值不符合预期的问题。
• 绑定信号前优先确认对应信号的传参规则，不要随意定义槽函数形参，避免误接信号传出的参数导致逻辑错误。

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