如何为Python应用安装Qt模块？PyQt5 QML导入Qt3D失败问询

为什么pip安装PyQt3D无效 #

PyPI提供的PyQt3D安装包通常仅包含Python侧的逻辑绑定代码，未打包对应的QML声明式模块文件，因此会出现QML导入时提示模块未安装的问题。

QML模块默认存放路径 #

不同系统、不同环境下的默认路径如下，可直接将你找到的Qt3D QML模块文件夹放入对应路径：

• Windows系统：
  全局Python环境下路径为你的Python安装目录\Lib\site-packages\PyQt5\Qt\qml
  虚拟环境下路径为你的虚拟环境目录\Lib\site-packages\PyQt5\Qt\qml
• macOS系统：
  全局Python环境下路径为/Library/Frameworks/Python.framework/Versions/你的Python版本号/lib/python你的版本号/site-packages/PyQt5/Qt/qml
  虚拟环境下路径为你的虚拟环境目录/lib/python你的版本号/site-packages/PyQt5/Qt/qml
• Linux系统：
  全局Python环境下路径为/usr/lib/python你的版本号/site-packages/PyQt5/Qt/qml或~/.local/lib/python你的版本号/site-packages/PyQt5/Qt/qml
  虚拟环境下对应路径为虚拟环境目录内的site-packages下PyQt5相关qml文件夹。

快速查询当前环境对应QML路径的方法 #

运行以下Python代码可以直接打印当前PyQt5环境识别的QML模块导入路径：

from PyQt5.QtCore import QLibraryInfo
print(QLibraryInfo.location(QLibraryInfo.Qml2ImportsPath))

输出结果就是你需要放置Qt3D QML模块的目标路径。

如果不想移动模块文件，也可以在加载QML引擎前手动添加模块搜索路径，示例代码如下：

from PyQt5.QtQml import QQmlApplicationEngine
from PyQt5.QtCore import QUrl

engine = QQmlApplicationEngine()
# 替换为你当前存放Qt3D QML模块的父文件夹路径
engine.addImportPath("/path/to/your/qt3d-qml-parent-folder")
engine.load(QUrl("main.qml"))

注意：你从Qt Creator安装的Qt3D QML模块需要和当前PyQt5使用的Qt版本完全匹配，否则会出现版本不兼容导致的导入失败。可运行print(QLibraryInfo.version().toString())查看当前PyQt5对应的Qt版本，和你Qt Creator安装的Qt版本核对一致后再使用。

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