在 Python 开发中,PyQt5 是一个强大的 GUI(图形用户界面)库,允许开发者创建美观且功能强大的桌面应用程序。随着 Python 3.12 的发布,很多开发者可能会遇到在新版本中安装 PyQt5 的一些问题。本文将详细介绍如何在 Python 3.12 环境中顺利安装 PyQt5。
1. 环境准备
确保你的系统已经安装 Python 3.12。可以通过以下命令检查 Python 的版本:
python --version
如果没有安装 Python 3.12,请前往 Python 3.12 官方下载网址 下载并安装。
2. 更新 pip
在安装任何第三方库之前,建议先更新 pip 以确保你拥有最新的包管理工具。可以使用以下命令更新 pip:
python -m pip install --upgrade pip
3. 安装 PyQt5
安装PyQT5有两种方法:
方法一:在设置 ——>项目:(项目名称)——>Python 解释器——>点击左上角的+号——>输入框中输入PyQT5——>点击安装软件包(I)
方法二:在终端或命令提示符中,运行以下命令以安装 PyQt5(第一个指令是从官网下载,第二个指令是从国内的镜像下载):
pip install PyQt5
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple PyQt5
4. 验证安装
安装完成后,可以通过运行以下 Python 脚本来验证 PyQt5 是否安装成功(如果能够成功运行并输出版本号,说明 PyQt5 已经成功安装):
import PyQt5
print("PyQt5 version:", PyQt5.__version__)
5.当安装成功后,原本应该去下载pyqt5-tools,但是在python 3.12版本中下载这个软件包会显示版本问题,查了很多资料发现最便捷的方法就是放弃下载pyqt5-tools直接下载PyQt5Designer,我使用的是直接在终端下载指令如下:
pip install PyQt5Designer
6.当PyQT5和PyQt5Designer都下载完成后,我们去配置外部工具
6.1 设置 ——>工具——>外部工具——>点击左上角的+号
首先创建第一个
名称:QtDesigner
描述:生成 .ui 的工具,也是设计工具可从tools—>External Tools调出
程序:1.如果你是在虚拟环境中安装的就打开venv\Lib\site-packages\QtDesigner\designer.exe
2.如果是在本地安装的就打开python的安装地址然后查询designer.exe
实参:不填写
工作目录:$FileDir$
第二个:
名称:PyUIC
描述:.ui 转化成 .py文件
程序: 1..如果你是在虚拟环境中安装的就打开venv\Scripts\pyuic5.exe
2.如果是在本地安装的就打开python的安装地址然后查询pyuic5.exe
实参:$FileName$ -o $FileNameWithoutExtension$.py
工作目录:$FileDir$
第三个
名称:PyRcc
描述:将资源文件如图片等转成python代码能识别的文件
程序: 1..如果你是在虚拟环境中安装的就打开venv\Scripts\pyrcc5.exe
2.如果是在本地安装的就打开python的安装地址然后查询pyrcc5.exe
实参:$FileName$ -o $FileNameWithoutExtension$.py
工作目录:$FileDir$
全部完成后可以运行
这段代码简单的构建一个窗口:
import sys from PyQt5.QtWidgets import QWidget, QApplication app = QApplication(sys.argv) widget = QWidget() widget.resize(640, 480) widget.setWindowTitle("Hello, PyQt5!") widget.show() sys.exit(app.exec())
如果出现下面这种报错
就在代码前加一段新的代码手动设置Qt平台的插件路径:
os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = r'C:\Users\zrw29\Desktop\qt测试\venv\Lib\site-packages\PyQt5\Qt5\plugins\platforms'