☰
PyQt5的安装(补)
2026/10/15 4:52:24 网站建设 项目流程

当前: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/simple

3. 安装PyQt5

python -m pip install PyQt5

使用国内镜像:

python -m pip install PyQt5 \ -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 安装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开发图形界面。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询