Mac OS X下QTreeView右键上下文菜单触发操作间歇性失效问题

根因定位 #

你的代码存在成员命名冲突问题：
类中同时定义了名为context_menu的成员方法（用于展示右键菜单）和同名的QMenu实例成员变量，在__init__执行时会用QMenu实例覆盖原方法的实例属性。
Windows和Linux下的PyQt绑定对这种重名场景的容忍度更高，信号绑定的初始方法引用能稳定生效；但Mac OS X的Qt事件调度逻辑对对象引用的校验更严格，会间歇性出现信号传递、菜单对象调用的引用混乱，导致操作触发失败。

修复步骤 #

1. 重命名QMenu实例的成员变量名，避免和方法名冲突，示例中将其改为self.right_click_menu
2. 同步调整方法内部调用菜单的变量名

修复后完整代码 #

import sys
from PyQt5 import QtGui
from PyQt5 import QtWidgets
from PyQt5 import QtCore

class main_ui(QtWidgets.QWidget):
    def __init__(self):
        super(main_ui, self).__init__()
        # set the window title and size
        self.setWindowTitle("Context menu trigger")
        self.resize(500, 300)
        # set the model
        self.model = QtGui.QStandardItemModel()
        self.model.setHorizontalHeaderLabels(["Variable"])
        # set the view and link it to the model
        self.view = QtWidgets.QTreeView()
        self.view.setModel(self.model)
        self.view.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
        self.view.customContextMenuRequested.connect(self.context_menu)
        self.view.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectItems)
        # 重命名菜单变量，避免和方法名冲突
        self.right_click_menu = QtWidgets.QMenu()
        self.plot_action = QtWidgets.QAction(self)
        self.plot_action.setText("Plot time series")
        self.plot_action.triggered.connect(self.plot_time_series)
        self.right_click_menu.addAction(self.plot_action)
        # create the model
        self.create_model()
        # set the layout
        layout = QtWidgets.QVBoxLayout(self)
        layout.addWidget(self.view)

    def context_menu(self, position):
        print("Displaying context menu")
        self.right_click_menu.exec_(self.view.viewport().mapToGlobal(position))

    def create_model(self):
        keys = ["Variable1", "Variable2", "Variable3"]
        for key in keys:
            self.model.appendRow([QtGui.QStandardItem(key)])

    def plot_time_series(self):
        print("In plot_time_series")

if (__name__ == '__main__'):
    app = QtWidgets.QApplication(["Test"])
    ui = main_ui()
    ui.show()
    sys.exit(app.exec_())

额外排查思路 #

如果修改命名后仍有偶发失效，可以尝试以下优化：

• 将QAction的父对象设置为QMenu而非主窗口，缩短信号传递路径
• 替换exec_为popup方法展示菜单，适配Mac的菜单渲染逻辑
• 检查是否存在其他同名成员变量/方法，避免类似引用冲突

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