PySide6加载QML文件时QQmlApplicationEngine报网络错误如何解决

• 核心触发原因：QQmlApplicationEngine.load()方法接收字符串参数时会默认按照URL规则解析路径，Windows系统下os.path.join生成的本地路径使用反斜杠\作为分隔符，被自动URL编码为%5C后引擎无法正常识别本地文件，最终抛出网络错误。
• 附加问题：你提供的main.py存在缩进错误，if __name__ == "__main__":下方的初始化代码没有正确缩进，会优先触发语法报错（如果实际运行没有提示语法错误，大概率是粘贴代码时格式丢失，也要注意核对缩进规则）。

推荐使用QUrl封装本地路径的方式解决路径解析问题，操作步骤如下：

1. 导入QUrl模块
2. 用QUrl.fromLocalFile()方法处理生成的本地路径，再传给load()方法
3. 修正代码缩进错误

修正后的完整main.py代码如下：

import sys
import os
from PySide6.QtCore import QUrl
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    # 处理QML文件路径
    qml_absolute_path = os.path.join(os.path.dirname(__file__), "qml/main.qml")
    engine.load(QUrl.fromLocalFile(qml_absolute_path))

    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec_())

如果不想额外导入QUrl，也可以直接把路径中的反斜杠替换为正斜杠，修改load行代码即可：

qml_path = os.path.join(os.path.dirname(__file__), "qml/main.qml").replace("\\", "/")
engine.load(qml_path)

修改完成后确认main.py同级目录下存在qml文件夹，且文件夹内有main.qml文件，即可正常运行。

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