QML布局与Padding在Qt Design Studio正常，Qt Creator+Python异常求助

问题场景 #

我编写的QML代码如下：

import QtQuick
import QtQuick.Window
import QtQuick.Controls
import QtQuick.Layouts

Window {
    visible: true
    width: 300
    height: 300
    title: "Padding test"

    Frame {
        anchors.centerIn: parent

        padding: 20

        ColumnLayout {

            spacing: 10

            Label {
                text: "Section"
                font.pixelSize: 20
                Layout.alignment: Qt.AlignHCenter
            }

            Repeater {
                model: 4

                delegate: Rectangle {
                    Layout.preferredWidth: 200
                    Layout.preferredHeight: 20
                    border.color: "black"
                    color: "lightBlue"
                }
            }
        }
    }
}

正常显示环境 #

在**Qt Design Studio 4.5.1（基于Qt 6.6.2）**中，显示符合预期：Frame的20px padding正常生效，内部ColumnLayout的内容四周留有空白，整体在窗口居中。

异常显示环境 #

在Qt Creator 13.0.2中，使用**Python 3.12.1 + PySide6（基于Qt 6.7.2）**运行相同代码时，显示不符合预期：Frame的padding未生效，ColumnLayout的内容紧贴Frame的边缘。

启动QML的Python代码：

import sys
from pathlib import Path
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    qml_file = Path(__file__).resolve().parent / "main.qml"
    engine.load(qml_file)
    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec())

疑问 #

1. 为何两种运行方式会有差异？
2. Python配置中是否缺少某些QML组件的加载？

目前无法让Qt Design Studio使用Qt 6.7.2，不确定是否是版本问题，猜测可能是Qt bug或需加载特定QML组件，恳请帮助。

解答 #

1. 差异原因 #

核心原因是Qt版本差异（6.6.2 vs 6.7.2），其次是运行环境的默认控件样式不同：

• Qt 6.7.x对QtQuick.Controls中的Frame控件与Layout组合的布局逻辑可能有调整，甚至存在已知bug，导致padding未正确作用于内部Layout；
• Qt Design Studio默认使用的控件样式（如Studio自带的设计样式）与PySide6默认的原生控件样式存在差异，样式的布局规则不同也会导致显示效果偏差。

2. 是否缺少组件加载？ #

你的Python配置没有缺少QML组件加载：代码中已经正确导入了QtQuick、QtQuick.Controls、QtQuick.Layouts等必要模块，PySide6的QQmlApplicationEngine会自动加载这些模块的默认实现。

解决方案 #

尝试以下几种方法解决显示问题：

• 指定控件样式：在QML开头导入具体的控件样式模块，强制统一风格，比如：

  import QtQuick.Controls.Material 2.15
  

  然后给Frame设置样式：

  Frame {
      anchors.centerIn: parent
      padding: 20
      style: Material.Style {}
      // ... 其余代码
  }
  

• 避开Layout与Frame的组合问题：将ColumnLayout替换为Column，手动设置anchors和margin来模拟padding效果：

  Frame {
      anchors.centerIn: parent
      padding: 20
  
      Column {
          anchors.fill: parent
          anchors.margins: 20
          spacing: 10
          // ... 其余代码
      }
  }
  

• 降级PySide6版本：安装基于Qt 6.6.x的PySide6版本，与Qt Design Studio的版本对齐：

  pip install pyside6==6.6.2
  

• 检查Qt bug报告：可前往Qt官方bug追踪平台查看6.7.x版本是否存在Frame与Layout相关的已知bug，若存在可等待后续版本修复。

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