为何在PyQt5+QML主窗口中无法看到绿色矩形？

我帮你排查了下代码，你看不到绿色矩形的核心原因是动态创建的QML元素没有正确关联到可视父项，另外也建议加上组件加载的错误检查，方便后续排查问题。

问题根源 #

QQuickItem（比如你用的Rectangle）有两个“父”概念：

• 一个是QObject层面的parent：用来管理内存、信号槽的父子关系，调用setParent()只会设置这个。
• 另一个是可视层面的parentItem：决定这个元素属于哪个可视容器，以及渲染时的坐标参考系，只有设置了它，元素才会被加入UI渲染树中显示。

你之前只调用了item.setParent(self.main_window.rootObject())，只设置了QObject的父，却没设置可视父项，所以绿色矩形虽然被创建了，但不会被渲染出来。

修改后的代码 #

下面是修复后的test.py，同时添加了路径的绝对路径处理（避免相对路径出错）和组件加载错误检查：

import os
import sys
from PyQt5.QtCore import QUrl
from PyQt5.QtGui import QGuiApplication
from PyQt5.QtQml import QQmlComponent
from PyQt5.QtQuick import QQuickView

os.environ["QML_DISABLE_DISK_CACHE"] = "true"

class Graphic:
    def __init__(self):
        self.main_window = QQuickView()
        # 使用绝对路径加载主窗口QML，避免相对路径问题
        main_window_path = os.path.join(os.path.dirname(__file__), "ui", "main_window.qml")
        self.main_window.setSource(QUrl.fromLocalFile(main_window_path))

    def load_screen(self):
        component = QQmlComponent(self.main_window.engine())
        # 同样用绝对路径加载矩形QML
        rect_path = os.path.join(os.path.dirname(__file__), "ui", "rectangle.qml")
        component.loadUrl(QUrl.fromLocalFile(rect_path))
        
        # 检查组件是否加载成功，方便排查语法或路径错误
        if component.status() == QQmlComponent.Error:
            print("加载QML组件出错：", component.errors())
            return
        
        item = component.create()
        if item:
            # 关键：设置可视父项，让矩形被加入主窗口的渲染树
            item.setParentItem(self.main_window.rootObject())
        self.main_window.show()

if __name__ == '__main__':
    app = QGuiApplication(sys.argv)
    graphic = Graphic()
    graphic.load_screen()
    app.exec()

额外说明 #

• 用os.path.join(os.path.dirname(__file__), ...)生成绝对路径，可以避免因为运行脚本的工作目录不同导致的路径错误，比直接写相对路径更可靠。
• 添加组件错误检查后，如果QML文件有语法错误或者路径不对，你能立刻看到错误信息，不用瞎猜哪里出问题。

这样修改后，你应该就能看到绿色矩形正常显示在主窗口里了。

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