PySide6 6.1.2环境QML导入QtGraphicalEffects提示未安装如何解决

• PySide6 6.1.x版本将QtGraphicalEffects模块归入Qt5Compat兼容组件包存放，该路径不在QML引擎的默认搜索路径列表中，即便dll文件存在，QML引擎也无法定位到模块配置文件，触发模块不存在的报错。
• 导入语句中指定的1.15为Qt5系列QtGraphicalEffects的版本号，与Qt6提供的兼容模块版本号不匹配，也会导致导入失败。

1. 先将Qt5Compat的QML目录加入QML引擎搜索路径，在Python侧初始化QQmlApplicationEngine的代码段中插入如下逻辑：

from PySide6.QtCore import QLibraryInfo
from PySide6.QtQml import QQmlApplicationEngine

# 初始化QML引擎
engine = QQmlApplicationEngine()
# 添加Qt5Compat的QML搜索路径
qt5_compat_qml_path = QLibraryInfo.location(QLibraryInfo.Qt5CompatQmlPath)
engine.addImportPath(qt5_compat_qml_path)

# 后续加载QML文件的逻辑保持不变

如果上述路径获取失效，可直接传入你本地找到的Qt5Compat下QML目录的绝对路径，例如engine.addImportPath(r"C:\Python39\Lib\site-packages\PySide6\qml\Qt5Compat")，路径按照你实际的PySide6安装位置调整即可。

2. 修改QML文件中的导入语句，删除原有版本号指定，或替换为Qt6对应的版本号：
   将import QtGraphicalEffects 1.15修改为import QtGraphicalEffects即可，需要指定版本的场景可使用import QtGraphicalEffects 6.1。

修改完成后重新运行程序即可正常导入使用QtGraphicalEffects模块的所有组件。

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