从PySide6导入Qt附加模块时提示‘module * is not installed’问题咨询

问题描述 #

从QML文件导入QtPositioning、QtLocation、QtMultimedia等Qt附加模块时，直接使用PySide6运行会触发module * is not installed错误，但在Qt Creator或Design Studio中运行默认项目无此问题。

解决方案 #

• 确认PySide6安装完整性
  执行pip show PySide6查看安装详情，确保安装的是完整版本。若模块缺失，重新执行pip install --upgrade PySide6完成完整安装。

• 手动添加QML插件路径到引擎
  PySide6的QML附加模块插件默认可能未被QML引擎自动识别，可在Python代码中手动添加插件路径：

  from PySide6.QtGui import QGuiApplication
  from PySide6.QtQml import QQmlApplicationEngine
  import os
  import sys
  
  if __name__ == "__main__":
      app = QGuiApplication(sys.argv)
      engine = QQmlApplicationEngine()
      
      # 获取PySide6的QML插件目录并添加到引擎
      pyside6_path = os.path.dirname(sys.modules['PySide6'].__file__)
      qml_plugin_path = os.path.join(pyside6_path, 'qml')
      engine.addImportPath(qml_plugin_path)
      
      engine.load(os.path.join(os.path.dirname(__file__), "main.qml"))
      if not engine.rootObjects():
          sys.exit(-1)
      sys.exit(app.exec())
  

• 配置环境变量
  设置QT_QML_IMPORT_PATH环境变量，指向PySide6的QML插件目录：

  • Windows：路径通常为C:\PythonXX\Lib\site-packages\PySide6\qml（XX为Python版本号）
  • Linux/macOS：路径通常为/usr/local/lib/pythonX.X/site-packages/PySide6/qml（X.X为Python版本号）
    添加后重启终端再运行PySide6项目。

• 验证插件目录存在
  前往PySide6安装目录下的qml文件夹，确认存在QtPositioning、QtLocation、QtMultimedia等对应模块的文件夹。若不存在，说明安装不完整，需重新安装PySide6。

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