完全弄懂如何用pycharm安装pyqt5及其相关配置

本文详细指导如何在Python中创建虚拟环境,安装PyQt5及其工具,并配置QtDesigner和PyUIC。关键步骤包括创建虚拟环境、设置项目解释器、安装所需库、环境变量配置和外部工具设置。
该文章已生成可运行项目,

一、配置专门的虚拟环境

原因:不同项目采用不同版本的python,所依赖的库的版本也不一样,为了避免版本冲突,所以给每一个项目每个python版本创建一个虚拟环境,环境中所使用的依赖库也是独立存在,不会被其他版本或其他项目的库影响。

1、单独创建一个文件夹来专门存放pyqt5的代码并建立虚拟环境

我在F盘的建了一个文件夹为python,在这个里面建立了一个文件夹python-pyqt5来专门存放代码,此时的python-pyqt5里面为空,没有任何文件

 2、进入pycharm,并打开python-pyqt5项目

步骤:点击File-->点击Open-->找到刚才建立的文件夹(python-pyqt5)-->点击OK

 3、配置虚拟环境

1、点击下方的Terminal,进入终端(必须确保终端上显示的路径与文件夹的路径一致

 

 2、在终端上输入

这个就是创建虚拟环境

python -m venv venv

 3、此时在Project项目中python-pyqt5就可以看到一个文件夹为venv,这个就是虚拟环境

 

二、配置虚拟的python环境

步骤 :1、点击File-->Settings

2、找到Project:python-pyqt5-->Project Interpreter(项目解释器)-->Add(添加解释器) 

 3、点击Virtualenv Environment-->Existing environment-->Interpreter

这里的解释器要选择我们创建的虚拟解释器的路径,最后要包括python.exe

 一路点击Ok回到Project Interpreter(项目解释器),会发现现在已经创建好了解释器,此时这里就只有两个默认的库,最后先点击右下方的Apply,在点击OK

这里的“(2)”不要管,这个是因为我已经创建了第二个这个的解释器。 如果是第一次创建,则这里就没有“(2)”

三、安装pyqt5和pyqt5-tools工具

在打开一个终端,这里要显示的venv,这样才算配置虚拟解释器成功,表示现在的环境是虚拟环境。

本次安装是使用的国内源,豆瓣网进行安装,安装速度会很快

1、安装:pyqt5

pip install pyqt5 -i https://pypi.douban.com/simple/

 出现Successfully,即为安装成功,出现黄色的不用管,这个是警告,一般是告诉pip需要进行更新

2、安装:pyqt5-tools

pip install pyqt5-tools -i https://pypi.douban.com/simple/

四、配置系统环境变量 

1、点击:控制面板右击-->点击系统-->高级系统设置-->系统变量-->Path

 

2、 打开文件夹到虚拟环境的界面

在这里进行搜索

 3、进行搜索:designer.exe

 4、右击-->打开文件所在的位置

 5、复制上面的路径:F:\python\python-pyqt5\venv\Lib\site-packages\qt5_applications\Qt\bin

添加到环境变量中

6、再次进行搜索:plugins

 7、点击最后一个文件并右击-->进入到文件所在位置

 点击plugins,进入该文件夹

 8、复制路径:F:\python\python-pyqt5\venv\Lib\site-packages\PyQt5\Qt5\plugins

并添加到系统变量中

变量名:QT_QPA_PLATFORM_PLUGIN_PATH
变量值:路径

五、配置Qt Designer

进入pycharm,点击File-->点击Settings-->Tools-->External Tools

 

添加额外组件的名字

Name:  

Qt Designer

额外组件的路径,这个路径就是designer.exe的路径

Program:: 

F:\python\python-pyqt5\venv\Lib\site-packages\qt5_applications\Qt\bin\designer.exe

 工作路径:

方法一:

Working directory:

$FileDir$

 方法二:

Working directory:F:\python\python-pyqt5

 由于我进行配置为第一种是会报错,出现路径不存在的问题,因此我改为的第二种方法,填写一个实际的路径

进入初始界面,按照如下步骤进行点击 

配置成功时,运行不会报错,并且会出现一个界面

出现这样的界面就代表Qt Designer配置成功

六、配置PyUIC

PyUIC:这个就是把我们设置的界面给编码.py文件

再次点击File-->点击Settings-->Tools-->External Tools-->点击+

 添加额外组件的名字

 Name:

PyUIC

 额外组件的路径 

Program: 

F:\python\python-pyqt5\venv\Scripts\pyuic5.exe

Arguments: 

$FileName$ -o $FileNameWithoutExtension$.py -x 

工作路径:

注:这个工作路径要和上面配置的Qt Designer工作路径一致。

Working directory:F:\python\python-pyqt5

配置成功后,按照以下步骤进行点击,如果配置成功,就会在文件夹中出现一个.py文件,这样就成功了。 

  

.py文件的内容

七、注意事项

1、要先有.ui文件,才能进行PyUIC转化,否则会报错

2、系统的环境变量一定要正确‘

3、不同的python版本的pyqt5的文件可能会有些不同,但是大体时一样的,只是文件的路径不同

本文章已经生成可运行项目
### 解决 PyCharm安装 PyQt5 报错的问题 在使用 PyCharm 开发基于 PyQt5 的项目时,可能会遇到诸如 `no Qt platform plugin could be initialized` 这样的错误提示。以下是针对该问题的解决方案: #### 1. **确认环境配置** 确保已正确安装 PyQt5 库以及其依赖项。可以通过以下命令验证是否成功安装: ```bash pip show PyQt5 ``` 如果未安装,则可以执行以下命令来安装: ```bash pip install PyQt5 ``` #### 2. **检查插件路径是否存在** 部分情况下,PyQt5 的 plugins 文件夹可能缺失或位置不正确。需手动检查并补充文件夹路径。通常,plugins 文件夹应位于如下目录之一: - Windows: `C:\PythonXX\Lib\site-packages\PyQt5\Qt5\plugins` - Linux/MacOS: `/usr/lib/pythonX.Y/site-packages/PyQt5/Qt/plugins` 若上述路径不存在 plugins 文件夹,可以从官方资源下载对应版本的 PyQt5 并解压至指定路径[^3]。 #### 3. **设置系统环境变量** 为了使 Qt 能够找到平台插件 (platform plugins),需要将 plugins 文件夹所在路径添加到系统的 PATH 变量中。具体操作步骤如下: - 打开系统属性 -> 高级 -> 环境变量。 - 编辑 PATH 变量,追加以下路径(假设 Python 版本为 3.x): ``` C:\PythonXX\Lib\site-packages\PyQt5\Qt5\bin C:\PythonXX\Lib\site-packages\PyQt5\Qt5\plugins ``` 完成后重启计算机以生效。 #### 4. **调整虚拟环境配置** 如果是通过 virtualenv 或 conda 创建的独立开发环境,可能存在路径冲突现象。此时建议重新创建一个新的虚拟环境,并按照前述方式重新安装 PyQt5 和其他必要组件。例如: ```bash python -m venv my_env source my_env/bin/activate # 在 Windows 下使用 `my_env\Scripts\activate` pip install PyQt5 ``` #### 5. **尝试替换 designer.exe 启动脚本** 某些特殊场景下,默认提供的 `designer.exe` 存在兼容性问题。可以考虑直接调用 PyQt 提供的设计工具替代默认选项。修改启动脚本指向新的可执行文件地址,比如: ```plaintext C:\PythonXX\Lib\site-packages\PyQt5\Qt5\bin\designer.exe ``` #### 6. **排查特定版本冲突** 有时不同版本间的差异也会引发此类异常。推荐升级至最新稳定版 PyQt5 来规避潜在 bug。同时注意保持 Python 基础解释器与目标库之间的匹配关系,避免因 ABI 不一致而产生的崩溃情况[^4]。 --- ### 示例代码片段 下面展示一段简单的测试代码用于验证当前环境中 PyQt5 是否正常工作: ```python import sys from PyQt5.QtWidgets import QApplication, QLabel app = QApplication(sys.argv) label = QLabel('Hello PyQt5!') label.show() sys.exit(app.exec_()) ``` 运行此脚本后应该能够看到一个显示文字的小窗口;否则表明仍有待解决问题存在。 ---
评论 40
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

牧锦程

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值