Ubuntu22.04下PySide6的QDialog无法居中于父级QMainWindow问题

问题背景 #

在Ubuntu 22.04（VirtualBox虚拟机，Wayland/mutter 42.0-3ubuntu2）中使用PySide6开发时，通过QMainWindow的菜单动作打开QDialog，对话框无法按文档说明居中于主窗口——主窗口移动后打开对话框，甚至会出现在屏幕左上角，完全偏离主窗口；但相同代码在Windows系统中可正常居中。

是否为已知问题 #

这是Wayland会话下Qt的已知兼容性问题。Wayland的窗口管理机制与传统X11不同，Qt在Wayland环境下的窗口位置布局逻辑（包括对话框居中）存在行为差异，虚拟机中的Wayland会话这类位置偏移问题更常见。

解决办法 #

1. 手动计算并设置对话框居中位置 #

通过代码手动计算主窗口与对话框的几何参数，强制将对话框移动到主窗口中心，这是最可靠的跨平台方案：

修改open_dialog方法，添加位置计算逻辑：

def open_dialog(self):
    dialog = Dialog(self)
    # 先调整对话框到合适尺寸
    dialog.adjustSize()
    # 计算主窗口中心位置对应的对话框左上角坐标
    parent_rect = self.geometry()
    dialog_rect = dialog.geometry()
    center_x = parent_rect.x() + (parent_rect.width() - dialog_rect.width()) // 2
    center_y = parent_rect.y() + (parent_rect.height() - dialog_rect.height()) // 2
    dialog.move(center_x, center_y)
    dialog.exec()

2. 强制使用X11平台运行程序 #

Wayland是Ubuntu 22.04的默认会话，但Qt在X11下的窗口行为更符合预期。可以通过设置环境变量强制程序使用X11（xcb）平台：

• 临时运行：在终端执行 QT_QPA_PLATFORM=xcb python3 your_script.py
• 永久设置：将 export QT_QPA_PLATFORM=xcb 添加到~/.bashrc或~/.profile文件中，重启终端后生效

3. 调整对话框窗口标志 #

尝试设置对话框的窗口标志，避免Wayland窗口管理器的自动布局干扰：

from PySide6.QtCore import Qt

class Dialog(QDialog):
    def __init__(self, parent):
        super().__init__(parent)
        self.setWindowFlags(Qt.Dialog | Qt.WindowTitleHint | Qt.WindowSystemMenuHint)

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