如何在QML中正确使用独立Python文件中声明的属性

我来帮你分析下问题所在，你遇到的TypeError: Cannot read property 'loaderSource' of undefined主要有两个关键点需要修正，咱们一步步来解决：

1. 修复CustomVariables类的初始化错误 #

你在CustomVariables的__init__里初始化的是self.loaderSource，但你的属性getter/setter操作的是self._loaderSource（下划线开头的私有变量），这就导致第一次调用get_loaderSource时，self._loaderSource根本没被定义，直接引发错误。

修改CustomVariables.py的__init__方法：

from PySide6.QtCore import QObject, Property, Signal

class CustomVariables(QObject):
    def __init__(self):
        super().__init__()  # 用super()调用父类构造更规范
        self._loaderSource = 'PageWork.qml'  # 改为初始化私有变量_loaderSource

    def get_loaderSource(self):
        return self._loaderSource
    
    def set_loaderSource(self, new_loaderSource):
        if self._loaderSource != new_loaderSource:  # 加个判断避免不必要的信号触发
            self._loaderSource = new_loaderSource
            self.loaderSourceChanged.emit()
        
    loaderSourceChanged = Signal()
    
    loaderSource = Property(str, get_loaderSource, set_loaderSource, notify=loaderSourceChanged)

2. 正确在BG类中实例化CustomVariables #

你之前尝试把cv放在__init__里是对的，但要确保是实例属性（用self.前缀），这样QML才能通过bg.cv访问到正确的实例。修改main.py中的BG类：

import sys
from pathlib import Path

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

from CustomVariables import CustomVariables

class BG(QObject):
    def __init__(self):
        super().__init__()
        self.cv = CustomVariables()  # 作为实例属性初始化，放在__init__里


if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()

    background = BG()
    engine.rootContext().setContextProperty("bg", background)

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

3. 保持QML中的访问方式不变 #

你的main.qml里的source: bg.cv.loaderSource是正确的，不需要修改：

import QtQuick.Controls.FluentWinUI3
import QtQuick

Window {
    id: root
    width: 1280
    height: 720
    visible: true

    Loader {
        id: projectLoader
        anchors.fill: parent
        asynchronous: true
        source: bg.cv.loaderSource
    }
}

这样修改后，你的属性就能正常在QML中访问和更新了。核心问题就是初始化时变量名不匹配，以及确保CustomVariables的实例是BG的实例属性，这样QML上下文才能正确找到它。

备注：内容来源于stack exchange，提问作者Daniel