Qt 6.4.2/PySide 6.4.2的move()在Ubuntu Wayland上失效原因咨询

问题现象 #

在安装全量更新的Ubuntu Wayland 22.04.1或22.10系统中，调用Qt或PySide的move()函数无法将窗口定位到指定坐标，窗口默认出现在左上角；但该函数在Ubuntu X11、Windows 10及其他桌面环境下可正常工作，且PySide2中也能复现此问题。

测试用例 #

PySide 6.4.2测试代码（通过PIP安装） #

from PySide6.QtWidgets import QApplication, QMainWindow
import sys

app = QApplication(sys.argv)
mainwindow = QMainWindow()

# Window move does not work on Ubuntu Wayland, works on X11:
mainwindow.move(1000, 600)

mainwindow.show()
app.exec()

Qt 6.4.2 C++测试代码 #

#include <QApplication>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QWidget w;    

    w.setWindowTitle("Window Move");
    w.setFixedSize(300, 200);    

    // Window move does not work on Ubuntu Wayland, works on X11
    w.move(1000, 600);    

    w.show();
    return a.exec();
}

跨平台差异原因 #

这种差异源于Wayland与X11、Windows的窗口管理架构本质不同：

• Wayland架构特性：Wayland采用客户端-服务器模型，桌面窗口的位置、布局权限完全由Wayland compositor（如GNOME Shell）掌控。应用程序只能向compositor发送窗口位置的请求，而无法直接强制设置窗口坐标——这是Wayland为了统一桌面布局管理、提升安全性而设计的核心规则。
• X11/Windows模型：X11允许应用程序直接控制窗口的位置参数，compositor通常不会拦截这类操作；Windows的窗口管理模型也赋予了应用更大的窗口控制权，因此move()函数可以直接生效。
• Qt适配缺失：Qt的move()函数没有针对Wayland的权限模型做适配，且官方已确认该问题但未进行修复，同时也未更新文档明确说明Wayland下的此限制，导致跨平台行为出现不一致。

已知问题状态 #

• PySide开发者已确认该问题（编号：PYSIDE-2190）
• Qt窗口开发者已确认该问题（编号：QTBUG-110119），但未开展进一步调查
• Qt文档未更新该功能限制，开发者忽略了文档更新的请求

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