PySide2/PyQt5中如何限制QMenu每列的菜单项数量？

QMenu 没有公开API可以直接指定列数、或者设置单列最大菜单项数。默认的自动拆列逻辑是Qt内部硬编码实现的：只有当菜单预估高度超过当前屏幕工作区可用高度90%左右时才会触发拆列，这就是你遇到的第一列撑满整个屏幕高度才生成第二列现象的根本原因。
要实现「每列最多N个菜单项就自动拆列」的需求，优先用下面的低侵入方案，不需要改动你现有的addAction调用逻辑。

推荐方案：继承QMenu自定义列布局规则 #

核心逻辑是关闭Qt默认的自动拆列、自动加滚动条的行为，在菜单弹出前根据动作总数主动计算需要的列数，固定单列高度触发多列布局。

核心实现代码 #

from PySide2.QtWidgets import QMenu
from PySide2.QtCore import Qt

class FixedColumnMenu(QMenu):
    def __init__(self, max_items_per_column: int = 20, parent=None):
        super().__init__(parent)
        self.max_per_col = max_items_per_column
        # 关闭菜单默认滚动条，强制优先走多列布局
        self.setStyleSheet("QMenu { menu-scrollable: 0; }")

    def _update_layout(self):
        all_actions = self.actions()
        action_count = len(all_actions)
        if action_count == 0:
            return

        # 计算需要的总列数
        col_num = (action_count + self.max_per_col - 1) // self.max_per_col

        # 计算单个菜单项的实际高度，取前3个可见项的平均值做基准，避免自定义项高度误差
        sample_height = 0
        valid_sample = 0
        for act in all_actions[:3]:
            geo = self.actionGeometry(act)
            if geo.height() > 0:
                sample_height += geo.height()
                valid_sample += 1
        item_height = sample_height // valid_sample if valid_sample > 0 else 32
        # 留2px边框余量，避免最后一项被截断
        col_height = self.max_per_col * item_height + 2

        # 应用布局参数
        self.setFixedHeight(col_height)
        self.setStyleSheet(f"""
            QMenu {{
                menu-scrollable: 0;
                column-count: {col_num};
                column-spacing: 6px;
                padding: 2px;
            }}
        """)

    def popup(self, pos, at_action=None):
        # 弹出菜单前自动调整布局
        self._update_layout()
        super().popup(pos, at_action)

使用方式 #

把你之前代码里实例化QMenu的地方替换成FixedColumnMenu(20)即可，原有添加动作、绑定Qt.CustomContextMenu右键触发的逻辑完全不需要改动。

• 如果菜单项包含自定义高度的控件（比如带大图标、多行文本的项），可以在_update_layout方法里遍历对应动作单独计算高度，适配不同尺寸的项。
• 列间距、内边距可以直接在样式表里调整数值，适配自己的UI风格。

不推荐方案：手动插入分隔符拆列 #

有部分开发者会每添加N个菜单项就插入特殊的换行分隔符强制拆列，但这个效果在Windows、macOS、Linux不同平台的Qt样式下表现不一致，很容易出现列宽错位、分隔符残留的问题，稳定性远不如自定义QMenu的方案。

注意：不要尝试调用Qt的私有API（比如非公开的setColumnCount方法）实现需求，不同PySide2/PyQt5版本的私有API签名差异极大，打包发布后很容易出现随机崩溃问题。

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