Windows10下PySide6加载qtquick2plugin.dll失败问题求助

问题描述 #

在Windows10系统的Python 3.11.1虚拟环境中，通过pip install pyside6安装PySide6后，运行程序出现QQmlApplicationEngine failed to load component错误，提示无法找到指定路径下的qtquick2plugin.dll——但文件实际存在，且已将路径添加到环境变量，问题仍未解决。

附代码：

main.py #

import sys

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

app = QGuiApplication(sys.argv)

engine = QQmlApplicationEngine()
engine.quit.connect(app.quit)
engine.load('main.qml')

sys.exit(app.exec())

main.qml #

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 600
    height: 500
    title: "HelloApp"

    Text {
        anchors.centerIn: parent
        text: "Hello World"
        font.pixelSize: 24
    }

}

解决方法 #

• 在代码中手动指定Qt插件路径
  虚拟环境中PySide6的插件路径一般为venv/Lib/site-packages/PySide6/plugins，在初始化QGuiApplication前添加代码强制指定路径，避免Qt加载错误：

  import os
  from PySide6.QtCore import QCoreApplication
  
  # 自动获取虚拟环境下的插件路径
  plugin_path = os.path.join(os.path.dirname(sys.executable), 'Lib', 'site-packages', 'PySide6', 'plugins')
  QCoreApplication.addLibraryPath(plugin_path)
  

  修改后的完整main.py：

  import sys
  import os
  from PySide6.QtGui import QGuiApplication
  from PySide6.QtQml import QQmlApplicationEngine
  from PySide6.QtCore import QCoreApplication
  
  # 设置Qt插件路径
  plugin_path = os.path.join(os.path.dirname(sys.executable), 'Lib', 'site-packages', 'PySide6', 'plugins')
  QCoreApplication.addLibraryPath(plugin_path)
  
  app = QGuiApplication(sys.argv)
  
  engine = QQmlApplicationEngine()
  engine.quit.connect(app.quit)
  engine.load('main.qml')
  
  sys.exit(app.exec())
  

• 确认环境变量生效与虚拟环境状态
  确保添加的环境变量是QT_PLUGIN_PATH，值为虚拟环境下的PySide6/plugins路径；添加后必须重启终端或IDE，保证环境变量实时生效，且运行程序前已激活虚拟环境。

• 调整PySide6版本
  部分PySide6版本与Python 3.11存在兼容性问题，尝试安装指定稳定版本：

  pip install pyside6==6.5.2
  

  或升级至最新稳定版：

  pip install --upgrade pyside6
  

• 匹配QML导入版本
  查看当前PySide6对应的Qt版本：

  from PySide6.QtCore import QT_VERSION_STR
  print(QT_VERSION_STR)
  

  将QML中的import QtQuick 2.15和import QtQuick.Controls 2.15替换为与输出版本匹配的号段。

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