PySide6中QListView右键菜单上下文匹配错误问题排查

核心问题：Lambda的延迟绑定陷阱 #

你遇到的问题是典型的循环中Lambda延迟绑定导致的。在循环创建QListView并绑定customContextMenuRequested信号时，Lambda表达式并不会立即捕获当前循环的view变量，而是在信号触发时才去读取这个变量的当前值。当循环结束后，view变量始终指向最后一个创建的QListView，所以所有右键菜单的操作都会关联到它。

两种可行的修复方案 #

方案1：Lambda默认参数捕获当前视图 #

在定义Lambda时，将当前循环的view作为默认参数传入。这样每次循环迭代时，Lambda会捕获当前的view实例（默认参数在定义时求值），而不是引用循环变量。

示例修改代码：

# 错误写法（导致所有绑定最后一个view）
view.customContextMenuRequested.connect(lambda pos: self.show_context_menu(pos, view))

# 正确写法：用默认参数捕获当前view
view.customContextMenuRequested.connect(lambda pos, v=view: self.show_context_menu(pos, v))

方案2：使用functools.partial绑定参数 #

借助functools.partial将处理函数和当前视图预先绑定，避免Lambda的引用问题。

先导入partial：

from functools import partial

假设你的show_context_menu函数定义为：

def show_context_menu(self, view, pos):
    global_pos = view.mapToGlobal(pos)
    menu = QMenu()
    action = menu.addAction(f"操作 {view.objectName()}")
    action.triggered.connect(lambda: self.on_menu_action(view))
    menu.exec(global_pos)

绑定信号时使用partial：

view.customContextMenuRequested.connect(partial(self.show_context_menu, view))

完整修复示例 #

以下是包含修复逻辑的完整代码框架：

from PySide6.QtWidgets import (QApplication, QMainWindow, QListView, 
                               QHBoxLayout, QWidget, QMenu, QAction)
from PySide6.QtCore import QStringListModel, Qt
from functools import partial
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("ListView右键菜单修复示例")
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QHBoxLayout(central_widget)
        
        # 创建三个ListView
        for i in range(3):
            view = QListView()
            view.setObjectName(f"ListView_{i+1}")
            model = QStringListModel([f"项目 {j+1}" for j in range(5)])
            view.setModel(model)
            # 启用右键菜单
            view.setContextMenuPolicy(Qt.CustomContextMenu)
            # 使用方案1：默认参数捕获当前view
            view.customContextMenuRequested.connect(lambda pos, v=view: self.show_context_menu(pos, v))
            layout.addWidget(view)
    
    def show_context_menu(self, pos, view):
        global_pos = view.mapToGlobal(pos)
        menu = QMenu()
        action = menu.addAction(f"查看 {view.objectName()} 的选中项")
        action.triggered.connect(lambda: self.print_selected_item(view))
        menu.exec(global_pos)
    
    def print_selected_item(self, view):
        index = view.currentIndex()
        if index.isValid():
            print(f"{view.objectName()} 选中项：{index.data()}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

运行这段代码后，每个ListView的右键菜单都会正确关联到自身，操作也会作用于对应的视图。

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