PyQt5运行Qt Design Studio生成的ui.qml文件缺失QtQuick.Studio模块如何解决

报错原因 #

QtQuick.Studio.Components是Qt Design Studio专属的组件库，默认不随PyQt5的标准运行环境分发，因此运行时无法找到对应模块。

最优解决路径 #

推荐优先选择第一种无额外依赖的方案，更适配后续树莓派跨架构部署需求：

方案1：移除Studio组件依赖（首选） #

• 打开所有.ui.qml文件，删除import QtQuick.Studio.Components 1.0导入语句
• 将文件中用到的Studio专属组件替换为QtQuick标准组件：大部分Studio基础组件和QtQuick.Controls 2.x的标准组件API高度兼容，仅需少量属性微调即可完成替换
• 无需修改现有Python加载代码，替换完成后可直接运行

方案2：手动导入Studio组件库（保留原UI文件时使用） #

如果不想修改原有Qt Design Studio生成的UI文件，可手动导入组件资源：

• Windows调试环境：找到本地Qt Design Studio安装目录下的qml/QtQuick/Studio文件夹，比如默认路径为C:\Qt\QtDesignStudio-版本号\qml\QtQuick\Studio，将整个Studio文件夹复制到你项目的导入路径下，保持目录结构为[你的导入根目录]/QtQuick/Studio，和导入语句的层级完全匹配即可；也可以直接在Python代码中新增Qt Design Studio的qml全局路径：

# 替换为你本地Qt Design Studio的qml目录实际路径
engine.addImportPath("C:/Qt/QtDesignStudio-xxx/qml")

树莓派部署说明 #

• 若使用方案1：仅需在树莓派系统中安装基础依赖即可，执行命令：
  sudo apt install python3-pyqt5 python3-pyqt5.qtquick qml-module-qtquick-controls2
  无需额外配置
• 若使用方案2：将之前复制到项目中的QtQuick/Studio文件夹一并打包上传到树莓派项目目录，保持导入路径结构不变即可，该组件库为纯QML实现，无二进制架构依赖，可直接在arm架构的树莓派上运行

调试小技巧 #

如果修改后仍提示找不到模块，可在加载engine前打印导入路径列表，确认配置的路径是否生效：

print(engine.importPathList())

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