QQmlApplicationEngine列表索引越界问题：运行PySide6 QML示例时触发IndexError报错

Let's break down what's happening here: that IndexError means your engine.rootObjects() list is empty, which tells us the QML file didn't load successfully. This is a common pitfall when migrating from PySide2 to PySide6, so let's walk through the fixes step by step.

First, Diagnose the Exact Load Failure #

The first thing you should do is add error checking right after loading the QML file. This will tell you why the load failed, instead of guessing. Update your main.py like this:

import sys
import os
from PySide6.QtCore import QUrl
from PySide6.QtQml import QQmlApplicationEngine
from PySide6.QtWidgets import QApplication

def say(s):
    print(s)

if __name__ == '__main__':
    app = QApplication(sys.argv)  # Don't forget sys.argv here for PySide6
    engine = QQmlApplicationEngine()
    
    # Use absolute path to avoid working directory issues
    current_dir = os.path.dirname(os.path.abspath(__file__))
    qml_file = os.path.join(current_dir, 'main.qml')
    engine.load(QUrl.fromLocalFile(qml_file))
    
    # Check for load errors
    if not engine.rootObjects():
        print("QML Load Errors:")
        for error in engine.errors():
            print(error.toString())
        sys.exit(-1)
    
    root = engine.rootObjects()[0]
    target_view = root
    target_view.say.connect(say)
    
    sys.exit(app.exec())

Fix the QML Compatibility Issues #

PySide6 uses Qt 6, which has updated QML module versions. Your original QML uses QtQuick 2.14, which might not play nice with Qt 6. Update your main.qml to use Qt 6-compatible imports:

import QtQuick 6.2
import QtQuick.Controls 6.2
import QtQuick.Window 6.2

Window {
    visible: true
    width: 600; height: 400
    signal say(string s)
    Button {
        text: "hello"
        onClicked: say(text)
    }
}

Why These Fixes Work #

• Absolute Path for QML: Running your script from a different working directory than where main.qml lives is a huge gotcha. Using os.path to build the absolute path ensures the engine always finds the file.
• Error Checking: The engine.errors() list will show you exactly what went wrong—like a missing import, typo in the filename, or version mismatch.
• Qt 6 QML Imports: Qt 6 standardized module versions to 6.x, so using the matching imports avoids compatibility issues that cause silent load failures.
• sys.argv for QApplication: PySide6 recommends passing command-line arguments to QApplication to handle system-level flags properly, which can prevent unexpected initialization issues.

After making these changes, your code should load the QML window correctly, and the say signal will connect without errors.

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