上位机开发____PyQt 环境配置指南

PyQt简介

在Python开发中，PyQt是一款GUI开发框架,即图形用户界面开发框架.，它允许开发者使用Python语言来编写具有原生外观和感受的跨平台图形用户界面（GUI）应用程序。PyQt是Qt库的Python绑定，结合了Python的简洁性和Qt框架的强大功能。本文将指导你完成在不同操作系统上配置PyQt环境的过程，包括安装Python、pip（Python包管理器）、以及PyQt本身。

市面主流的两款Python的GUI开发框架,分别是pyqt以及PySide,他们的区别是,PYQT底层是由C++开发而成，采用PyQt开发GUI，后面可以进一步转C++开发Qt，因此，如果想要入手图形用户界面开发，PyQt是非常推荐的一款框架，需要注意的是，PyQt有两种许可协议，分别是GPLv3许可证和需要购买版权的商业许可证，GPLv3是强开源协议，意味着，如果你的应用程序里面使用了PyQt，那么你的程序必须开源，否则可能收到法院传票，如果想要闭源商用，就必须购买Riverbank Computing公司的商业许可证。

但如果你既想享受Qt的强大功能，又想闭源商用，那么PySide适合你，说到PySide，就不得不说Qt与PyQt之间的恩怨，Qt的研发公司是Nokia，Riverbank Computing公司使用Python封装了Qt研发出PyQt，而PyQt从诞生时就是GPLv3协议，因此Nokia与Riverbank Computing谈判，希望将PyQt的协议修改为LGPLv3，可以带来更多的商业用户，但是两个公司谈崩了，所以Nokia自己重新研发了Py版本的Qt也就是PySide，后来Nokia将Qt和PySide卖给了Digia公司。PySide官网：Qt for Python

我这里用的是PyQt5的版本,最新版的是PyQt6,但是PyQt5相对来说生态更完善,和最新版的区别也不大,所以还是使用PyQt5的版本

总结：

• 如果不做商业项目，强烈建议使用PyQt，资料多，稳定。全局替换成PySide也很方便。
• 需要开发闭源商用软件的就用PySide。所有API用起来几乎一样。
• PyQt5的对应版本是PySide2

那么下面就一起来看看pyqt的环境配置详细流程

1. 确保Python已安装

首先，确保你的系统中安装了Python的编译器。PyQt支持Python 3.6及以上版本。你可以通过终端或命令提示符检查Python是否已安装及其版本：

可以用快捷键win+r,打开cmd,输入python查询编译器的版本,我这里用的python 3.9.13的版本

如果没有安装Python，可以从Python官方网站下载并安装。

2. 通过pip安装PYQT

pip是Python的包管理器，用于安装和管理额外的库和依赖。大多数现代Python安装都会自带pip，但如果你的环境中没有，请按照以下步骤安装：

对于Windows：

因为我主要用的是windows进行开发,所以基于mac系统和linux系统的pip安装可以参考其他博主的博客,不在这里进行过多赘述.

从Python官方网站下载安装时，通常会自动勾选安装pip。如果没有安装，可以通过重新运行安装程序并选择“修复”选项来添加pip。

插件安装:

下面的指令都是在cmd进行的,如何打开cmd上文已经说过,不再赘述.按步骤进行操作即可完成安装.

需要注意的是: pip安装的包都存在于外国的服务器上，速度会非常慢，所以需要给pip配置国内镜像，直接从国内服务器安装依赖。这里我用的镜像源是清华大学的镜像网址.

pip install 插件名字    # 安装
pip uninstall 插件名字    # 卸载
pip install 插件名字 -i 指定下载的镜像网址
pip show 插件名字        # 查看插件名字

------------------------------------------------------------------

上面是指令,作参考即可.下面才是详细操作

------------------------------------------------------------------

# 安装PyQt5
pip  install  PyQt5  -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装Qt工具软件
pip install PyQt5-tools -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装PyQt5语法检测包（可选）
pip install PyQt5-stubs -i https://pypi.tuna.tsinghua.edu.cn/simple
# 查看安装版本
pip  show  PyQt5
pip  show  PyQt5-tools
pip  show  PyQt5-stubs

3. 无法运行处理

如果运行PyQt程序报如下错误，不报错不需要配置！：

则将如下变量添加到系统环境中：

QT_QPA_PLATFORM_PLUGIN_PATH

值为：

%LOCALAPPDATA%\Programs\Python\Python39\Lib\site-packages\PyQt5\Qt5\plugins\platforms

重启编辑器或控制台即可

注意这里的%LOCALAPPDATA%\Programs\Python\Python39是你的Python安装路径，如果安装时不是默认路径，请将此部分内容替换成自己的安装路径。

建议直接使用Everything搜索qoffscreen.dll，找到目录

4. VSCode配置PYQT插件

安装PYQT Integration插件，可以帮我们自动生成UI相关代码和资源。最好进行如下配置：

1. 配置.ui生成的.py文件中导入资源的路径：--import-from=ui 指向ui目录
2. 配置designer.exe可执行程序的路径，例如我的路径：D:\Programs\Python\Python39\Lib\site-packages\qt5_applications\Qt\bin\designer.exe
3. 在Python安装路径下找designer.exe，建议用everything搜索designer.exe。如果搜不到，请先确保已安装PyQt5-tools, 安装方法：pip install PyQt5-tools,保存designer.exe的路径,添加到Pyqt-integration>Qtdesigner:Path下方的输入框内即可