WSL2环境下PySide6+QML窗口无法居中启动求助

环境配置 #

• Windows 11
• WSL2-Ubuntu 22.04
• Python 3.11.2
• PySide6 6.4.3
• 单显示器（2560x1440）

问题现象 #

尝试通过QML计算窗口居中位置，但每次启动应用时窗口位置都不固定，已尝试StackOverflow相关方案均无效。

现有代码 #

main_file.py #

from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

app = QGuiApplication()
engine = QQmlApplicationEngine()

engine.load("qmls/mainscreen.qml")

app.exec()

qmls/mainscreen.qml #

import QtQuick
import QtQuick.Controls

Window {
    id: root
    visible: true
    width: 320
    height: 480

    Component.onCompleted: {
        var x_calc = (root.Screen.width / 2) - (root.width / 2)
        var y_calc = (root.Screen.height / 2) - (root.height / 2)

        root.x = x_calc
        root.y = y_calc
    }

    TextInput{
        width: 580
        height: 300
        horizontalAlignment: TextInput.AlignHCenter
        verticalAlignment: TextInput.AlignVCenter
    }
}

解决方案 #

问题根源 #

WSL2环境下，QML直接通过root.Screen获取屏幕尺寸可能受虚拟屏幕识别延迟影响，导致坐标计算偏差；同时Component.onCompleted执行时机早于屏幕信息完全加载，进一步加剧位置不准确问题。

修改方案 #

1. 明确指定主屏幕：用Screen.primaryScreen获取物理显示器参数，避免虚拟屏幕干扰。
2. 延迟位置计算：监听窗口visibilityChanged信号，在窗口可见后再执行居中计算，确保屏幕信息已加载完成。
3. 修正布局异常：调整TextInput尺寸，避免超出窗口边界引发的布局混乱。

修改后的qmls/mainscreen.qml：

import QtQuick
import QtQuick.Controls

Window {
    id: root
    visible: true
    width: 320
    height: 480

    onVisibilityChanged: {
        if (visible) {
            var screen = Screen.primaryScreen
            var x_calc = (screen.width / 2) - (root.width / 2)
            var y_calc = (screen.height / 2) - (root.height / 2)
            root.x = x_calc
            root.y = y_calc
        }
    }

    TextInput{
        width: root.width - 40  // 留边距避免超出窗口
        height: root.height - 40
        horizontalAlignment: TextInput.AlignHCenter
        verticalAlignment: TextInput.AlignVCenter
    }
}

额外注意事项 #

确保WSL2的XServer转发配置正确，使用VcXsrv或WSLg时，勾选“Disable access control”选项，保证Qt应用能准确识别物理显示器尺寸。

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