序言

上一篇关于 PyQt5 的文章已经是 6 年前的了， 已经有很多地方已经过时了

今天系统的重新写一篇关于 PyQt5 环境搭建。 系统是 Windows 10， Windows 11 的话， 应该也适用。 相差不大

重点是 Python 版本， 经过本人几个小时的实测， 截至到 2024.12.31 日， 本文下面的步骤都是基于 Python 3.11.11， Python 3.12 以上版本经实测， 无法正常安装 Designer。

安装 PyQt5

首先说一下搭建 PyQt5 环境， 正常是需要 PyQt5 库本身， 以及辅助开发的 Designer 的， 但是 PyQt5 库本身是不含有 Designer 的， 需要自行安装， 由于 Designer 依赖于 PyQt5， 所以我们只需要安装 Designer 就行。

换句话说， 安装 Designer 的时候， 由于依赖会将 PyQt5 一起安装。所以可以把直接使用如下命令：

pip install pyqt5-tools

至此， PyQt5 及相关 Designer 安装完毕。

配置 PyCharm

我一般使用 PyCharm 进行开发， 因此就写 PyCharm 的一些配置。 先一次打开 PyCharm Settings -> Tools -> External Tools -> 点击加号 进行新建 Tool 操作

首先是 Designer 的配置。如图：

Tool Settings 的三个内容如下：（请将目录修改为自己的路径， 下同）

Programs: D:\anaconda3\envs\pyqt\Scripts\pyqt5-tools.exe

Arguments: designer

Working Directory: $ProjectFileDir$

Designer 用于设计 UI 界面,  也可以用这个， 但是推荐上面的设置， 因为下面设置的打开 designer 之后， 在关于插件里面是空的。

Programs: D:\anaconda3\envs\pyqt1\Lib\site-packages\qt5_applications\Qt\bin\designer.exe

Arguments: 

Working Directory: $ProjectFileDir$

然后设置 PyUIC， 如图：

Tool Setting:

Programs: D:\anaconda3\envs\pyqt\Scripts\pyuic5.exe

Arguments: $FileName$ -o ui_$FileNameWithoutExtension$.py

Working Directory: $FileDir$

UIC 是用于将 Designer 设计的界面转换成 Python 脚本， 可以直接使用， 很便利。

最后是 PyRCC 的设置， 如图：

Programs: D:\anaconda3\envs\pyqt\Scripts\pyrcc5.exe

Arguments: $FileName$ -o $FileNameWithoutExtension$_rc.py

Working Directory: $FileDir$

保存完设置之后， 可以选中一个 qt 的 ui 设计文件使用 pyuic 工具编译一下， 生成的 python 文件可以使用就 OK 了。

Mac 相关设置

由于我的 Mac 电脑是公司配的机器， 存在很多限制， 因此就没截图， 我把关键配置提供到下方， 具体操作和 Windows 相差不多

首先不同之处在于， PyQt5-tools 是 Windows 平台的 python 包， 因此不能直接使用 pip 进行安装。

第一步： 先创建一个 Python 虚拟环境。

第二步： 使用 pip install PyQt5 命令安装 PyQt5 模块

第三步： 使用 brew install pyqt@5 命令安装 homebrew pyqt5 包， 应该也可以直接用 brew install qt@5， 没有试过， 存疑。

第四步： 相关文件路径如下

Designer：

/opt/homebrew/Cellar/qt@5/5.15.16/bin/Designer

UIC：

/Users/{xxx}/miniconda3/envs/pyqt/bin/pyuic5

RCC: 

/Users/{xxx}/miniconda3/envs/pyqt/bin/pyrcc5

其他设置同上文 Windows 设置， 至此就 OK 了

愉快地敲代码吧

结语

关于 Windows 和 Mac 上配置 PyQt5 开发环境就结束了， 和几年前的文章相比， 还是有一些不同。

如有错误， 敬请指出， 感谢指正!    — 2024-12-31  18:45:06