当前:PyQt5安装教程 / 只保留安装与验证步骤
PyQt5安装与环境配置
1. 检查Python环境
打开CMD或PyCharm终端,执行:
python --version再检查pip:
python -m pip --version如果都能正常显示版本信息,就可以继续安装。
2. 更新pip
python -m pip install --upgrade pip如果下载速度较慢,可以使用清华镜像:
python -m pip install --upgrade pip \ -i https://pypi.tuna.tsinghua.edu.cn/simple3. 安装PyQt5
python -m pip install PyQt5使用国内镜像:
python -m pip install PyQt5 \ -i https://pypi.tuna.tsinghua.edu.cn/simple4. 安装Qt Designer
Qt Designer可以通过拖拽控件设计界面。安装命令如下:
python -m pip install pyqt5-tools使用国内镜像:
python -m pip install pyqt5-tools \ -i https://pypi.tuna.tsinghua.edu.cn/simple安装后,designer.exe通常位于:
Python安装目录\Lib\site-packages\qt5_applications\Qt\bin\designer.exe如果使用PyCharm虚拟环境,位置通常为:
项目目录\.venv\Lib\site-packages\qt5_applications\Qt\bin\designer.exe双击designer.exe即可启动Qt Designer。
同样也可右击根目录,选择外部工具,如果之前在设置—工具—外部工具里设置了就会显示Qt Designer
配置如下:
实参为:$FileName$ -o $FileNameWithoutExtension$_rc.py
5. 验证PyQt5是否安装成功
执行:
python -m pip show PyQt5如果能够显示版本和安装位置,说明安装成功。
再运行下面的测试代码:
import sys from PyQt5.QtWidgets import QApplication, QLabel, QWidget app = QApplication(sys.argv) window = QWidget() window.setWindowTitle("PyQt5安装测试") window.resize(400, 250) label = QLabel("PyQt5安装成功", window) label.move(140, 100) window.show() sys.exit(app.exec_())运行后能够出现窗口,就说明PyQt5可以正常使用。
6. 将UI文件转换为Python文件
Qt Designer保存的文件格式为.ui,例如:
win1.ui转换命令:
pyuic5 -o win1.py win1.ui如果系统提示找不到pyuic5,可以使用:
python -m PyQt5.uic.pyuic win1.ui -o win1.py转换完成后会生成:
win1.py这里同样可以右键:
7. 找不到PyQt5的解决方法
如果出现:
ModuleNotFoundError: No module named 'PyQt5'一般是因为安装PyQt5的Python环境和运行代码的Python环境不同。
在PyCharm中打开:
文件 → 设置 → 项目 → Python解释器确认当前解释器中已经安装PyQt5。也可以直接在PyCharm终端重新执行:
python -m pip install PyQt5完成以上步骤后,就可以正常使用PyQt5和Qt Designer开发图形界面。