【PyQt5桌面应用开发】1.可视化环境搭建步骤（超级详细）

深碍√TFBOYSˉ_ 2024-03-17 09:01 56阅读 0赞

**目录**

安 装

安装 PyQt5

安装 PyQt5-tools

安装 QT Designer

验证是否安装成功

使用 PyCharm 开发

新建工程

添加外部工具

helloworld 工程

关于 QT

本文主要介绍在 Window平台下如何安装PyQt5，以及如何在 PyCharm 下开发配置。

### 安 装 ###

#### **安装 PyQt5** ####

`PyQt5` 有两种安装方式，一种是从官网下载源码安装，另外一种是使用 `pip` 安装。

这里我推荐大家使用`pip` 安装。因为它会自动根据你的Python 版本来选择合适的 `PyQt5` 版本，如果是手动下载源码安装，难免会选择出错。建议使用比较稳妥的安装方式。

pip3 install PyQt5

另外，如果你的网络访问外网不是很好的话建议使用豆瓣的镜像下载，不然会很很慢或者直接安装失败。

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

#### 安装 PyQt5-tools ####

`PyQt5` 不再提供常用Qt工具，比如图形界面开发工具Qt Designer、国际化翻译工具Liguist 如果开发中使用到这些，必须自行安装Qt工具。

这里我们还是采用脚本安装的方式。

pip install PyQt5-tools

或者使用镜像下载：

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

#### 安装 QT Designer ####

另外，`window` 平台， `PyQt-tools` 默认安装 `QT Designer.exe`。

#### **验证是否安装成功** ####

执行以下代码：

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())

如果没有报错，弹出了一个标题为"Hello, PyQt5!"的窗口，则说明安装成功。

### 使用 PyCharm 开发 ###

安装 `PyCharm` 这里就不再阐述了。直接每次点击“下一步，默认安装就可以。

这里我安装的是社区版。

![b87dbd6c79cd48d3ba3073cbf78b7b47.png][]

安装成功之后，打开 `PyCharm` 我们设置两个 `extern tools` .

*  通过PyCharm 打开 QT Designer
 *  通过PyCharm 将 `xxx.ui` 文件 转成 `xxx.py` 文件

我们通过新建一个工程完整的讲解一下这部分。

#### 新建工程 ####

比如我们新建一个 `helloword` 工程. 选择 文件 -> 新建项目

![9bc88fdfbcd44cf1af9ab34f956131d5.png][]

新项目取名： `helloworld`

这里不使用 `Pipenv` 、`Virtualenv` 、`Conda` 等环境管理器。

Python` 版本可以指定。当前我用的是 `Python3.9

![format_png][]

创建成功之后的界面：

![format_png 1][]

![format_png 2][]

#### 添加外部工具 ####

`PyCharm` \-> 文件 -> 设置 -> 工具 -> 外部工具

然后选择 "+"

![format_png 3][]

这里是我已经添加成功之后的截图

我们先**添加 `QT Designer`**，可以参考截图设置。

*  "名称" : 这里可以自定义的
 *  "程序"：选择的是 "designer.exe" 的安装目录, 具体的可以参考 **QT Designer节**
 *  "工作目录": 根据实际情况配置，这里我直接使用的是 宏 **`$FileDir$`**

![9dfcab9b0a72c1348c643561c73e5f28.png][]

添加 `Pyuic`

*  "名称": 这里可以自定义的
 *  "程序"：选择的是 "pyuic5.exe" 的安装目录
 *  "实参"：**`$FileName$ -o $FileNameWithoutExtension$.py`**
    
     *  意思将选中的 `xxx.ui` 文件转换为同名的 `xxx.py`文件
     *  需要特别注意的是，执行的时候需要右键选中对应的 `xxx.ui` 文件，不然会出错的。
 *  "工作目录": 根据实际情况配置，这里我直接使用的是 宏 **$FileDir$**

![8d0469dbcbe1d7db97b4d9726858cdd8.png][]

#### helloworld 工程 ####

新建 `new.ui` 文件

![format_png 4][]

![format_png 5][]

点击创建

![format_png 6][]

创建成功之后的界面

![format_png 7][]

添加个 Label

![format_png 8][]

输入helloworld

![format_png 9][]

字体调大点

![format_png 10][]

保存ui文件

这里我命名为 `helloworld.ui`

![format_png 11][]

保存

在 `PyCharm` 可以看到 `helloworld.ui` 文件

![format_png 12][]

将 `helloworld.ui` 文件转换为 [helloworld.py][] 文件。

**再次强调下，一定要选中对用的 `ui` 文件进行转换。**

![format_png 13][]

一定要注意选中对应的ui文件

可以看到新的 `helloworld.py` 文件

![format_png 14][]

运行看下最终效果。

![format_png 15][]

运行之后的界面

###  ###

### **关于 QT** ###

`QT SDK` 包括`Qt`库、`Qt Creator IDE` 和`Qt-tools`，这些都集成在一个易于安装的文件包里。

`Qt Creator` 用户是不需要单独的 `Qt Designer` 程序，但是还有很多`Qt`的用户，他们是不使用`Qt Creator`的，此时编辑 `ui`文件的话，只能用 `Qt Designer`了。

[b87dbd6c79cd48d3ba3073cbf78b7b47.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/294776b8a91748bdbdeac0fcc8d24f47.png
[9bc88fdfbcd44cf1af9ab34f956131d5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/e89de06ce5074bd7aa1191b3ec8c5f8e.png
[format_png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/29cff3120f3a42109f4964d635de266f.png
[format_png 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/d9625bb0ce5d4e8cbf32562c87e7b870.png
[format_png 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/5509c5431ef748cd9a6deb3913f6f286.png
[format_png 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/429128e782a84de6a019befc643c6304.png
[9dfcab9b0a72c1348c643561c73e5f28.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/17ddc04ef1664d1da10e9d9034156e89.png
[8d0469dbcbe1d7db97b4d9726858cdd8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/728162acfd204ec0b61b2abb6c7927fe.png
[format_png 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/43703e9b61d84c01b7d0e8c2444fc4bb.png
[format_png 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/a915caf747ce4674b9541446693d5633.png
[format_png 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/b8b90470dafe484fa0807c6527ae8a72.png
[format_png 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/49420c6103694d1fb9a28813bd980c14.png
[format_png 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/dc3248f1722b46c1872c39089c773263.png
[format_png 9]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/e97e09f9b8ea41cf88888f00d9a62f65.png
[format_png 10]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/13179829748e4424938e1a5948254d50.png
[format_png 11]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/d5d0b0dfb5014f3caa1b7b8b0439f7c7.png
[format_png 12]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/c1d6dce299f7435fae5167abe8ed9f23.png
[helloworld.py]: https://link.zhihu.com/?target=http%3A//helloworld.py/
[format_png 13]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/74d845437548410bb0f1f5c4ba6a6d9a.png
[format_png 14]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/9f1ae4981df84484b24bc5aa06809812.png
[format_png 15]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/17/56575c7e0b69401c812831b3890e8daf.png