Qt 6.2 Windows平台菜单首次打开出现截断问题如何解决

问题属性确认 #

该现象是Qt 6.2.0~6.2.3版本Windows平台的已知官方缺陷，由菜单首次渲染时尺寸计算逻辑错误导致，和业务代码实现无关。
其触发条件与描述完全匹配：

• 仅Windows 10/11系统复现，macOS平台无该问题
• 受影响菜单固定满足：倒数第二个元素是分隔符，最后一个为普通菜单项
• 仅首次打开菜单时出现最后一项截断，二次打开时尺寸已完成正确计算即可正常显示，触发菜单重建（如系统语言切换、动态增删菜单项）后会再次触发首次截断

解决方案 #

方案1：升级Qt版本（优先推荐） #

该缺陷已在Qt 6.2.4及所有Qt 6.3及以上版本中正式修复，直接升级到对应稳定版本即可从根源解决问题，无需修改业务代码。

方案2：现有Qt 6.2.0版本临时规避 #

如果暂时无法升级Qt版本，可采用以下任意一种方案绕过问题：

• 主动预计算菜单尺寸：主窗口初始化完成后，遍历所有菜单栏下的子菜单，通过单次延时调用触发尺寸计算，代码示例：

// 放在主窗口构造函数末尾执行
QTimer::singleShot(0, this, [=](){
    for (auto* menu : ui->menuBar->findChildren<QMenu*>()) {
        menu->adjustSize();
    }
});

• 调整菜单项结构：对受影响的菜单，避免出现「分隔符+单个菜单项」作为菜单末尾的结构，可删除末尾多余的分隔符，或在最后一个菜单项之后添加一个隐藏的空白菜单项，打乱错误计算的触发条件。
• 自定义QMenu子类：重写QMenu的showEvent方法，首次弹出时强制调用adjustSize刷新尺寸。

内容的提问来源于stack exchange，提问作者RED SOFT ADAIR