- PySide 6/PyQt 6快速开发与实战
- 孙洋洋等
- 2664字
- 2025-02-17 14:12:07
1.2 搭建PySide 6/PyQt 6环境
本节主要讲解如何在常见的计算机平台上搭建PySide 6/PyQt 6环境,包括搭建PySide 6/PyQt 6环境的流程和一些注意事项。
1.2.1 在Windows下使用PySide 6/PyQt 6环境
对于初学者来说,独立搭建PySide 6/PyQt 6环境比较困难。为了减轻读者的负担,笔者为本书封装了可以运行书中所有程序的绿色版的PySide 6/PyQt 6环境,解压缩后即可使用,不会影响系统的默认环境,适合对Python刚入门的初学者或不想为本书重新安装一个环境的老手使用。该绿色环境获取方式参见本书源代码的readme.md文件,源代码获取方式参见本书前言。
那么如何使用这个环境呢?以PySide 6环境为例,笔者的计算机目录的位置为D:\WinPython\WPy64-3870-pyside6,如果读者想安装与管理模块,则可以通过这个文件来管理(D:\WinPython\WPy64-3870-pyside6\WinPython Command Prompt.exe)。打开文件,如图1-2所示,在这里可以看到当前Python环境下的所有信息,可以使用这个环境作为PyCharm和VSCode等IDE的解析器。

图1-2
1.2.2 在Windows下自行搭建PySide 6/PyQt 6环境
如果读者要自行搭建PySide 6/PyQt 6环境,则应首选Anaconda。Anaconda是开源的Python发行版本的安装包工具,包含Conda、Python等180多个包及其依赖项。因为Anaconda包含大量的包,所以下载文件比较大,如果只需要某些包,或者需要节省带宽/存储空间,那么也可以使用Miniconda这个比较小的发行版。建议初学者直接使用Anaconda,这样可以不用考虑安装包相互依赖的问题,本书也以Anaconda为基础进行介绍。
Miniconda是一个免费的Conda最小的安装程序软件,是Anaconda的一个小型引导版本,仅包含Conda、Python、它们所依赖的包,以及少量其他有用的包。使用conda install命令可以从Anaconda存储库中安装720多个额外的Conda包。
截止到2022年2月,Conda还未实现对PyQt 6的支持,其最新版本支持Qt 5.9,和Qt 6.2存在一些冲突,需要额外解决冲突,而使用Miniconda则没有这个问题,所以本书以Miniconda为例介绍PySide 6/PyQt 6环境的搭建。
需要注意的是,本节内容默认以Python主环境运行,熟悉Python环境的读者可自行虚拟环境。
1.下载Anaconda或Miniconda
读者可以根据自己计算机安装的系统选择相应的版本进行下载,下面以Windows为例展开介绍。下载Python 3.9和64位的Anaconda,如图1-3[1]所示。

图1-3
Miniconda可下载最新版本,笔者下载的是Windows 64位安装包,对应Python 3.9,如图1-4和图1-5所示。

图1-4

图1-5
接下来简单介绍Miniconda的安装步骤,供读者参考。在安装Miniconda的过程中,一直采取默认方式并单击Next按钮,如图1-6所示。笔者习惯安装在D:\Anaconda3目录下,当然,也可以使用其他目录或默认目录。

图1-6
对于最后一个安装界面中的复选框,建议Python初学者全部勾选,如图1-7所示,这样Conda会提供最全的Python环境。如果读者对Python很熟悉,并且不打算破坏本地Python环境,那么可以不勾选。
如果勾选图1-7中的第1个复选框,则自动添加环境变量,随便打开一个cmd窗口就可以使用Conda的Python环境,如图1-8所示。
如果不勾选图1-7中的第1个复选框,则系统默认找不到Conda的Python环境,此时可以将Conda看作一个便携版的Python环境,需要使用另一种方法进入Conda环境,即选择“开始”→“最近添加”命令,找到命令行Anaconda Prompt(miniconda3),这样就可以进入Conda默认的Python环境,如图1-9所示。需要注意的是,每次使用这个环境都要按照上述步骤操作一次。

图1-7

图1-8

图1-9
右击Anaconda Prompt(miniconda3)文件,打开该文件的属性窗口,查看该文件的属性,可以看到这是一种快捷方式,如图1-10所示。

图1-10
该文件执行的是如下命令:

读者可以复制一个副本,在重装系统时通过副本也能使用这个环境,当然,也可以自行创建这样的快捷方式。
如果勾选图1-7中的第2个复选框,则可以方便IDE查找Python环境,读者可以根据需求进行选择。
当勾选了图1-7中的两个复选框之后,系统环境变量会添加几条路径。查看环境变量的方法如下:右击“此电脑”,在弹出的快捷菜单中选择“属性”命令,在打开的窗口中单击“高级系统设置”链接,在打开的“系统属性”对话框中单击“环境变量”按钮,在“变量”列打开Path选项即可。这里有两个Path,上面的Path只影响当前用户,下面的Path会影响整个系统,也就是说会影响系统的所有用户。以笔者的计算机为例,会添加包含D:\miniconda3的几个目录,如图1-11所示。

图1-11
因为D:\miniconda3已经被添加到环境变量中,系统会从这些环境变量中查找python.exe并返回,所以使用where python能返回D:\miniconda3\python.exe。
安装好Miniconda之后,在“开始”菜单中有两种进入Conda环境的快捷方式,如图1-12所示。
如果是Anaconda,则“开始”菜单中会多出一些非常好用的工具,如Jupyter Notebook、Spyder等,如图1-13所示,可以通过双击来使用这些工具。

图1-12

图1-13
2.安装PySide 6/PyQt 6
安装PySide 6最简单的方法是使用pip命令。使用以下两条命令(其中第2条命令是使用国内镜像下载,速度非常快)都可以安装PySide 6:

同理,安装PyQt 6可以使用以下两条命令:

如果使用的是Miniconda,那么到这里PySide 6/PyQt 6的安装就结束了。如果使用的是Anaconda,那么还需要下面的步骤。
在安装好Anaconda之后,默认自带Python Qt环境,因为开源的IDE Spyder是基于这个环境开发的(默认是PyQt)。在本书完稿之际,Spyder依赖的环境还是PyQt 5.9,这也是Anaconda的Python Qt环境,但这不符合笔者的要求,所以需要手动更新,代码如下:

此时的Spyder使用的是PyQt 5,在安装PySide 6/PyQt 6时和Spyder有版本冲突,如果运行PySide 6/PyQt 6代码,那么会出现qt.qpa.plugin: Could not find the Qt platform plugin"windows"in""错误,产生这种错误的原因是Conda找到的Qt版本信息是由PyQt 5提供的,解决方法是把D:\Anaconda3\Lib\site-packages\PySide6\plugins路径下的所有文件复制到D:\Anaconda3\Library\plugins路径下完成替换。但采用这种方法会导致系统的PyQt 5不能使用,基于PyQt 5的Spyder也不能使用。
1.2.3 在macOS和Linux下搭建PySide 6/PyQt 6环境
1.在macOS下搭建PySide 6/PyQt 6环境
在macOS下搭建PySide 6/PyQt 6环境的步骤和在Windows下搭建PySide 6/PyQt 6环境的步骤基本一致,笔者在这里仅测试了Miniconda的安装。在官方网站下载Miniconda安装包,笔者选择的是pkg版本,如图1-14所示,可以进行可视化安装。在安装过程中,一直采取默认方式并单击Next按钮即可,直接进入Conda环境。

图1-14
在安装完Miniconda之后,就需要安装PySide 6,使用pip命令安装即可:

至此,macOS的Python环境和PySide 6环境就搭建完成,后面在安装IDE时可以自动识别这个环境。
笔者只测试了PySide 6,没有对PyQt 6进行测试,因为截止到PySide 6~PySide 6.2.3,pyside6-designer.exe文件在命令行中打不开,出现的错误提示如图1-15所示。

图1-15
2.在Linux下搭建PySide 6/PyQt 6环境
测试计算机使用的是国产深度系统社区版(版本号为20.4),因为用的是最新的Python和PySide 6,如果系统版本太老,就会由于编译器版本太低而出现兼容性问题,这一点需要注意。
在官方网站下载Miniconda安装包,选择Linux的第1个版本。下载完成后,需要在控制台安装,命令如下:

单击操作过程中的“下一步”按钮,直到输入yes等就完成了安装,效果如图1-16所示,重启终端就会自动进入Conda环境。

图1-16
在重启终端之后,再次打开终端就可以安装PySide 6:

这样Python环境和PySide 6环境就搭建好了,如图1-17所示,系统已经可以正确识别这个环境。

图1-17
1.2.4 测试PySide 6/PyQt 6环境
在搭建好Python环境之后,就需要对环境进行测试。如果要测试PySide 6环境是否安装成功,则使用PySide6/Chapter01/testFirst.py文件;如果要测试PyQt 6环境是否安装成功,则使用PyQt6/Chapter01/testFirst.py文件。以PySide 6为例,其完整代码如下:

在Windows系统中,双击testFirst.py文件,或者在Windows命令行窗口中运行如下命令:

如果没有报错,则弹出如图1-18所示的窗口(Widget),说明PySide 6/PyQt 6环境安装成功。

图1-18