![PySide 6/PyQt 6快速开发与实战](https://wfqqreader-1252317822.image.myqcloud.com/cover/388/46418388/b_46418388.jpg)
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的解析器。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_29_1.jpg?sign=1738855982-Ygyk66kW94vfkMIJbjMjHpVsn7VFfSYO-0-ee6b55156c110e5168b9331253bc5928)
图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]所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_30_1.jpg?sign=1738855982-Lu4qUMrvOI59MOowSK3Hpm7AHZRa2ksA-0-9666a03d6da6e7b06912ae004b53b578)
图1-3
Miniconda可下载最新版本,笔者下载的是Windows 64位安装包,对应Python 3.9,如图1-4和图1-5所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_30_2.jpg?sign=1738855982-j9ywQizT4KokqPzhFlYoDN1TTgs8V2TB-0-76681c018da00de889b3873da6f2a335)
图1-4
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_31_1.jpg?sign=1738855982-FFhLqGgLv9vKYFKvfLn8IQsBwXwY1Wn0-0-a3e73fe46e153fc7c360415032c40984)
图1-5
接下来简单介绍Miniconda的安装步骤,供读者参考。在安装Miniconda的过程中,一直采取默认方式并单击Next按钮,如图1-6所示。笔者习惯安装在D:\Anaconda3目录下,当然,也可以使用其他目录或默认目录。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_31_2.jpg?sign=1738855982-tJolZMxJxMJ3tx4zUpPnn0OSsyldhTsG-0-2a107901bb5f91fd9a7fffa21274c632)
图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所示。需要注意的是,每次使用这个环境都要按照上述步骤操作一次。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_32_1.jpg?sign=1738855982-5VHGkYPkcJSCzmeC0IGL8qXCEgBFTZ1E-0-bfb311c5f076cc4f7f241a18ad295321)
图1-7
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_32_2.jpg?sign=1738855982-7QcsNmtdpPp9DETHYghnAEq1kPFvcqdU-0-4a89c6fcd0ffe49d2842e0086cf5af9a)
图1-8
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_32_3.jpg?sign=1738855982-XUY26dbu9m0w8O4vaEYw5hjAlb8go0BB-0-20f5837dce99d2db7dcc262d65493464)
图1-9
右击Anaconda Prompt(miniconda3)文件,打开该文件的属性窗口,查看该文件的属性,可以看到这是一种快捷方式,如图1-10所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_33_1.jpg?sign=1738855982-vDEV8KTJKumAVmdJMlSeV1dFfqJGdWXj-0-eed03f7234f761f0ea700a34ad3e52da)
图1-10
该文件执行的是如下命令:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_33_2.jpg?sign=1738855982-lFKD1XV9kp1qR0651Us0jtMYK2Cbu9hR-0-3197648f12699108f2f43cefced5a245)
读者可以复制一个副本,在重装系统时通过副本也能使用这个环境,当然,也可以自行创建这样的快捷方式。
如果勾选图1-7中的第2个复选框,则可以方便IDE查找Python环境,读者可以根据需求进行选择。
当勾选了图1-7中的两个复选框之后,系统环境变量会添加几条路径。查看环境变量的方法如下:右击“此电脑”,在弹出的快捷菜单中选择“属性”命令,在打开的窗口中单击“高级系统设置”链接,在打开的“系统属性”对话框中单击“环境变量”按钮,在“变量”列打开Path选项即可。这里有两个Path,上面的Path只影响当前用户,下面的Path会影响整个系统,也就是说会影响系统的所有用户。以笔者的计算机为例,会添加包含D:\miniconda3的几个目录,如图1-11所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_33_3.jpg?sign=1738855982-7wnvvigQa0jjSDqlHIjCS9k7nslGXIxt-0-45b663a151de4b53b470474875e979e9)
图1-11
因为D:\miniconda3已经被添加到环境变量中,系统会从这些环境变量中查找python.exe并返回,所以使用where python能返回D:\miniconda3\python.exe。
安装好Miniconda之后,在“开始”菜单中有两种进入Conda环境的快捷方式,如图1-12所示。
如果是Anaconda,则“开始”菜单中会多出一些非常好用的工具,如Jupyter Notebook、Spyder等,如图1-13所示,可以通过双击来使用这些工具。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_34_1.jpg?sign=1738855982-nBA8fyJWtSMiODNrUHgRMTGfM6ekjyIB-0-334b8745e741db4e2cfcaceb66ba52f6)
图1-12
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_34_2.jpg?sign=1738855982-2p95F6pCIxZn4wD8CwSyBBr0l19sJHGW-0-0527399ec8a6d2cb69009b9f541c47bf)
图1-13
2.安装PySide 6/PyQt 6
安装PySide 6最简单的方法是使用pip命令。使用以下两条命令(其中第2条命令是使用国内镜像下载,速度非常快)都可以安装PySide 6:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_34_3.jpg?sign=1738855982-tS1Ntoat6mbvjVMK9uboDdhwGYym4ISe-0-4f7847ec09ea526328d882c093fb760e)
同理,安装PyQt 6可以使用以下两条命令:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_34_4.jpg?sign=1738855982-TuIh7AO6ho4d5jukzmCBfSRHa1qJl15F-0-830aee2cf61c440c08d99d745169e2c0)
如果使用的是Miniconda,那么到这里PySide 6/PyQt 6的安装就结束了。如果使用的是Anaconda,那么还需要下面的步骤。
在安装好Anaconda之后,默认自带Python Qt环境,因为开源的IDE Spyder是基于这个环境开发的(默认是PyQt)。在本书完稿之际,Spyder依赖的环境还是PyQt 5.9,这也是Anaconda的Python Qt环境,但这不符合笔者的要求,所以需要手动更新,代码如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_35_1.jpg?sign=1738855982-4KCYQF7zp0DUJzc9bEykjLxOUmly1Q1j-0-7df36589ef100b62c9e92ba3b2a963c8)
此时的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环境。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_35_2.jpg?sign=1738855982-nxpnOgdiDcgEj36JwpTDa0GxPdPLJVb5-0-6d28f1b84c886ccd8bfb642f10b0093e)
图1-14
在安装完Miniconda之后,就需要安装PySide 6,使用pip命令安装即可:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_35_3.jpg?sign=1738855982-f1cgR5ghF3IDbUGpeb1FDOkl7PSBZMR5-0-9d994fb2b3162c98b5f06e0ab2cadb25)
至此,macOS的Python环境和PySide 6环境就搭建完成,后面在安装IDE时可以自动识别这个环境。
笔者只测试了PySide 6,没有对PyQt 6进行测试,因为截止到PySide 6~PySide 6.2.3,pyside6-designer.exe文件在命令行中打不开,出现的错误提示如图1-15所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_36_1.jpg?sign=1738855982-9ih6Nmb56WOWRgY70xXtOImKW39dnk6i-0-c8df0211d9808b49952509a14dd0e62e)
图1-15
2.在Linux下搭建PySide 6/PyQt 6环境
测试计算机使用的是国产深度系统社区版(版本号为20.4),因为用的是最新的Python和PySide 6,如果系统版本太老,就会由于编译器版本太低而出现兼容性问题,这一点需要注意。
在官方网站下载Miniconda安装包,选择Linux的第1个版本。下载完成后,需要在控制台安装,命令如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_36_2.jpg?sign=1738855982-bXAztta9Q222t2mj7VkjcZAQMmOgdt4J-0-ce80ab13c619be4b8817457bdd4527e1)
单击操作过程中的“下一步”按钮,直到输入yes等就完成了安装,效果如图1-16所示,重启终端就会自动进入Conda环境。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_36_3.jpg?sign=1738855982-MLd0uF8sLbsQkGhjLmLxS97QfRvYTmQk-0-ebcc1d106a8e71b6594af1bc18c019af)
图1-16
在重启终端之后,再次打开终端就可以安装PySide 6:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_37_1.jpg?sign=1738855982-PSNSb36w7lRlBLrxRbteEMzlsoXIwc2v-0-91f41401aee9e4d492891e2f544099b4)
这样Python环境和PySide 6环境就搭建好了,如图1-17所示,系统已经可以正确识别这个环境。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_37_2.jpg?sign=1738855982-tvFcY9XPJTFRxB7myxwNBxJrifpJeYvN-0-efc9f162fb8f3e58a7b24d915b293026)
图1-17
1.2.4 测试PySide 6/PyQt 6环境
在搭建好Python环境之后,就需要对环境进行测试。如果要测试PySide 6环境是否安装成功,则使用PySide6/Chapter01/testFirst.py文件;如果要测试PyQt 6环境是否安装成功,则使用PyQt6/Chapter01/testFirst.py文件。以PySide 6为例,其完整代码如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_37_3.jpg?sign=1738855982-YzKJVO8UIEjD6FxFu78O3ITjyAgPwUor-0-bccd2bc6e6103cd327b02e11d3ebc64a)
在Windows系统中,双击testFirst.py文件,或者在Windows命令行窗口中运行如下命令:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_37_4.jpg?sign=1738855982-PGrgEUiJmMOAZyOEMucap2sHDlgvV66g-0-4248b8d2f85fa467aa038554617ba10b)
如果没有报错,则弹出如图1-18所示的窗口(Widget),说明PySide 6/PyQt 6环境安装成功。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_37_5.jpg?sign=1738855982-fosDzUSgeKFskOyj8sNxwxv6yUpl5G3L-0-1565b7589ca8049382cded2ac3b886d4)
图1-18