![PySide 6/PyQt 6快速开发与实战](https://wfqqreader-1252317822.image.myqcloud.com/cover/388/46418388/b_46418388.jpg)
1.4 常用IDE的安装配置与使用
本节介绍使用Python开发PySide/PyQt的过程中会用到的3个IDE工具,分别为Eric、PyCharm和VSCode。这3个IDE工具中的任何一个都可以用来开发PySide/PyQt,读者可以根据自身需求选择使用。Eric对初学者比较友好,当读者对PySide/PyQt熟悉之后,使用专业的IDE工具(如PyCharm)会更好一些。
以下内容都是基于Windows系统进行介绍的。
1.4.1 Eric 7的安装
Eric是一个功能齐全的Python编辑器和IDE,使用Python编写。它基于跨平台Qt UI工具包集成了高度灵活的Scintilla编辑器控件。Eric既可以作为编辑器,也可以作为专业的项目管理工具,为Python开发人员提供许多高级功能。Eric包括一个插件系统,不仅允许用户自行下载插件,还可以轻松扩展IDE功能。最新的稳定版本是基于PyQt 6和Python 3的Eric 7,Eric有如图1-25所示的一些特征。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_43_1.jpg?sign=1738857658-mpDxx1e5qx5djDVEYj0Ixbfjf778NOMF-0-d3c639ccf5660545285aedc2c36766d3)
图1-25
访问Eric官网,下载最新的Windows系统下的Eric 7安装包。
截至本书成书时,Eric的最新版本为7-22.2,如图1-26所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_43_2.jpg?sign=1738857658-r0RFZoGZwSYAgPcLj3PxGnE3Kn2ZgzN2-0-8e04fd82bdeb01cb203515a7a26f8875)
图1-26
准备好安装环境之后,就可以开始安装Eric 7。在下载完安装包之后先对其进行解压缩,然后进入解压缩目录,双击install.py文件开始安装Eric 7,或者在命令行输入python install.py,使用方式如图1-27所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_44_1.jpg?sign=1738857658-taVPOnMxg1B5aofjIzndo3KOkSLG9z0Y-0-5ab7b55140f24e1fd0dfeeaaaafb71cc)
图1-27
安装完成之后,会在桌面生成快捷方式eric7(Python3.9),其目标路径为D:\miniconda3\Scripts\eric7.cmd,如图1-28所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_44_2.jpg?sign=1738857658-iOEgVJs0sXOmiJNXZW3guLVI58Giwzjx-0-6ff2e576a5b5971ab114fd183058f57a)
图1-28
1.4.2 Eric 7的相关配置
Python环境是系统默认的,可以被IDE识别到,因此不需要进行额外的配置,如果读者有其他需求则可以根据自己的需求进行其他设置。
打开Eric 7,选择setting→show external tool命令,可以看到,PySide 6/PyQt 6的环境已经被识别到,如图1-29所示,Qt的各种工具都能够被检测到。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_45_1.jpg?sign=1738857658-ur6aGo8gaoFBg6ZOqNxsB1O0xN1owPEn-0-2209aff4d770227857c66b524b23f872)
图1-29
1.4.3 Eric 7的基本使用
本节主要讲解使用Eric 7开发PySide 6/PyQt 6应用。本节以开发PySide 6应用为例进行介绍,工程文件保存在Chapter01/ericProject目录下。下面讲解初学者使用Qt Designer开发PySide 6应用的典型流程。
(1)打开Eric 7,选择Project→Open命令,打开项目工程文件Chapter01\ericProject\ericPySide6.epj,可以看到如图1-30所示的视图。
图1-30中有1、2、3这3个选项。第1个选项用于编辑代码文件(.py文件);第2个选项的功能是使用Qt Designer编辑.ui文件,以及使用其他工具编译.ui文件(转换成.py文件);第3个选项用来编译资源文件.qrc。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_46_1.jpg?sign=1738857658-LkxNUKDbG03SpB9Qj49dTwl08HKsUzp2-0-9c180735965df67a6e0bbdc76acf8eae)
图1-30
(2)切换到第2个选项,双击testFirst.ui文件,通过可视化的方式创建GUI文件,如图1-31所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_46_2.jpg?sign=1738857658-AaTlDP1XchWMx4bfRx6YNzJRdqTEhuFV-0-362cd798f1fe2afa0332f92e59ec3e89)
图1-31
双击testFirst.ui文件,对应的cmd命令行如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_46_3.jpg?sign=1738857658-qAMR0G7wohdcbuayWHaqJLHCMoLwdlTI-0-8a10a9008aefe93a333cfd25c2b96488)
先保存编辑完的.ui文件,右击testFirst.ui文件,在弹出的快捷菜单中选择Compile form命令,如图1-32所示,编译文件,把testFirst.ui文件转换为Ui_testFirst.py文件。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_47_1.jpg?sign=1738857658-HTwQjhCd0xB7iIi7XQOjmXi5VjhfpNfS-0-e67a38269a6122d4846d268366d1d225)
图1-32
这一步对应的cmd命令行如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_47_2.jpg?sign=1738857658-CI6JlcblZ9VVtQkMPKnqFVfc1cMp6Cbd-0-5c6a0f2b52a64f58d003d5c482ac8684)
可以看到,此时更新了Ui_testFirst.py文件。
(3)切换到第3个选项,进入资源管理界面,可以看到.qrc文件,即资源管理文件,里面存储的是图片与引用路径信息。右击resource.qrc文件,在弹出的快捷菜单中选择Compile resource命令,如图1-33所示,这样就可以把resource.qrc文件编译成resource_rc.py文件。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_47_3.jpg?sign=1738857658-QoRrELTQK18xU0oNhICF111IjzCk4YNM-0-ba093bf9fe6dadd77e6a4f9dfac5ec75)
图1-33
这一步对应的cmd命令行如下:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_48_1.jpg?sign=1738857658-hssfVs5kxHK7EGYsWAnEVumoRNKRJeEs-0-b78a7a34ee1f3d8353b587559d542da5)
可以看到,此时更新了resource_rc.py文件。
需要注意的是,由于PyQt 6放弃了对资源的支持,即不会提供pyrcc6.exe工具,因此不会显示如图1-33所示的界面。另外,使用PyQt 6运行这个案例的demo不会显示图片。
(4)切换到第1个选项,选中testFirst.py文件,先单击“运行”按钮(或按快捷键F2),再单击PushButton按钮,就会弹出如图1-34所示的提示框。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_48_2.jpg?sign=1738857658-dAD7NERbNQ4EOuFI0pkZ6H1CbvKcMLPC-0-3c750b1df879fe0f3f646989be31c723)
图1-34
由图1-34可知,程序正常运行并且显示了图标。
如果使用的是Anaconda,但版本基于PyQt 5,则可能不会正确显示图标。这是因为Qt 5和Qt 6的版本不匹配,解决方法是把D:\Anaconda3\Lib\site-packages\PySide6\plugins路径下的所有文件复制到D:\Anaconda3\Library\plugins路径下并替换。
下面介绍如何建立工程文件夹。选择Project→New命令,弹出如图1-35所示的对话框,图中1、2、3处的内容需要修改。1是工程名称,对应的文件是ericPySide6.epj;2是工程类型,下拉列表中包含PySide6 GUI和PyQt6 GUI这两个选项,笔者创建的是PySide6工程,所以选择PySide6 GUI选项,这很重要,这样这个工程会自动选择pyside6-uic.exe来编译.ui文件;3是工程文件夹路径。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_49_1.jpg?sign=1738857658-YvSehOAZVFtJ5JgD8FbKmIUJPbIMxa8V-0-59ae2ac83e7e92cc6c51dc641648b060)
图1-35
1.4.4 PyCharm的安装
PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python开发时提高其效率的功能,如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制等。此外,该IDE提供了一些高级功能,可以用于支持Django框架下的专业Web开发。PyCharm是Python开发最常用的IDE工具,也是笔者日常开发Python程序的主力军。
PyCharm有免费的Community(社区)版本和收费的Professional(专业)版本。如果开发PySide/PyQt,则Community版本就足够用。Community版本和Professional版本的区别如图1-36所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_49_2.jpg?sign=1738857658-qkZCBr8OL1CUqxlZSQLimIFXyIQX9oRO-0-dc108f104e2e9c52d7faafec82df0a74)
图1-36
可以从官方网站下载PyCharm,在下载页面中选择Community版本,如图1-37所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_50_1.jpg?sign=1738857658-QqSI1hhCC5FU2L3Um1tv7rj6Ed8mhFJZ-0-268c28314b623d9260f7001738021c81)
图1-37
安装完PyCharm之后,会在桌面创建快捷方式,笔者创建的快捷方式的名称为PyCharm Community Edition 2021.3.2,打开这个工具,要新建一个Project需要打开如图1-38所示的窗口。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_50_2.jpg?sign=1738857658-lNMlO6OBRIQ1CIkiEPLhoHhA40H92VvJ-0-6af4c05c33c710d70c294c9a6f5d4620)
图1-38
进入PyCharm主程序界面,选项默认都是英文的,可以通过安装插件对选项进行汉化。选择File→Setting命令,打开Settings对话框,下载Chinese插件并应用,重启后即可进入中文界面,如图1-39所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_51_1.jpg?sign=1738857658-rxaLjlz2mSqEn65ZWg6r0OWt7JmbXfJT-0-dfaf58cce52c0d854a563daa5e2c9830)
图1-39
1.4.5 使用PyCharm搭建PySide 6/PyQt 6环境
因为PyCharm支持多个Python环境,所以需要指定一个Python环境(Anaconda环境),本节主要介绍在对PySide 6/PyQt 6进行开发的过程中使用Qt工具的方法。如图1-40所示,为开发环境添加几个PySide 6/PyQt 6的外部工具,方便快速创建、编辑和编译.ui文件,以及编译.qrc文件,以及快速查看帮助等。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_51_2.jpg?sign=1738857658-WQh3dTpsUYOpLsiHsdngAT2NrZkXe9JA-0-6a1da378c82190d201c737ae87514245)
图1-40
1.外部工具的使用
使用这些外部工具非常简单,具体的使用方法和执行效果如图1-41所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_52_1.jpg?sign=1738857658-PPaW8S62Kf79KuGs7sun8IzdD0mq9UhW-0-2115d08c3aa2491b0e2661653e66969b)
图1-41
由此可知,PySide 6/PyUIC这个外部工具实际上执行的是如下所示的cmd命令:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_52_2.jpg?sign=1738857658-pr7oFVVAOAvDpkAFuZRvNWNYD6ugafzs-0-e95f7e7900c011d7b3b4adc0470d5a15)
2.配置PySide6/PyUIC
创建外部工具的步骤如图1-42所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_52_3.jpg?sign=1738857658-2Rjm6kkovstkRYpNCYoR8cR0mwqp3C3z-0-b1b3dd1c8fed92f0a602ef9b23513157)
图1-42
下面仍然以PySide 6/PyUIC为例进行介绍。创建外部工具需要注意以下几点。
(1)图1-42中的位置4表示外部程序,此处的路径为D:\Anaconda3\Scripts\pyside6-uic.exe,读者应参考自己计算机的实际路径。
(2)图1-42中的位置5表示参数,此处填写的是$FileName$-o$FileNameWithoutExtension$UI.py,在执行过程中,以firstMainWin.ui文件为例,$FileName$转译为firstMainWin.ui,$FileNameWithoutExtension$UI.py转译为firstMainWinUI.py,最终执行的命令是D:\Anaconda3\Scripts\pyside6-uic.exe firstMainWin.ui-o firstMainWinUI.py。
1.4.6 PyCharm的基本使用
下面简单介绍PyCharm的一些常用方法。
1.打开文件夹
选择“文件”→“新建项目”命令,打开如图1-43所示的对话框,选择要打开的文件夹,设置完成后单击“创建”按钮。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_53_1.jpg?sign=1738857658-HGnc7iXPGLpbhU06QDfAroFMC9ZUR7Fx-0-972469c95491d2f4aadd6cff940e0cdc)
图1-43
在弹出的提示框中单击“从现有的源创建”按钮,如图1-44所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_53_2.jpg?sign=1738857658-agLXbhBVp3HnGsKLP1igwK7cMAHdXVBp-0-5dc5dfa0af41c5af8a3e8b368ca88f8d)
图1-44
在打开的界面中可以对本书的源代码进行编辑操作,如图1-45所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_54_1.jpg?sign=1738857658-o0bk6lEbHjBozh3WuT7EsfBZK8TH9tUq-0-7b26a6155cdd757dd5f9e95b2d8050bc)
图1-45
2.运行文件
选择“运行”→“运行”命令即可启动文件,在第一次启动之后就可以使用窗口右上角的快捷方式,主要包括“运行”和“调试”两种快捷方式,如图1-46所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_54_2.jpg?sign=1738857658-Jj1VlI4fI6V19qyw86SxMf0g5OO5fMi1-0-fe1d2b23f4a8806617426f2b7fbc8e50)
图1-46
3.调试文件
假设已经成功运行了文件,则可以通过如图1-47所示的方式进行调试,可以看到这种调试方式和使用IPython Console编写代码的体验是一样的。
4.使用PySide 6/PyQt 6的一些工具
可以通过PyCharm快速打开Qt Designer、PyUIC、PyRcc、Qt帮助文档等工具,这种方式的配置方法在1.4.5节已经介绍了,这里不再赘述。具体的使用方法如图1-48所示,该操作会使用Qt Designer命令打开layoutContainer.ui文件。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_55_1.jpg?sign=1738857658-nfMXDGBL95IFSw1aA21FcwbfEuWKAks8-0-0d0bc2c4a70ea6d8cd6392efee13565c)
图1-47
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_55_2.jpg?sign=1738857658-UyQoLkJjVjs1PCdHLvB8hKifGsMnNwYz-0-ee3a48fc96596d85ee9bd072287f02fd)
图1-48
5.使用其他Python环境
如果想要使用其他Python环境,如虚拟环境,则可以在如图1-49所示的“设置”对话框中进行修改。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_56_1.jpg?sign=1738857658-kdT3UZMVgyE0UX8VTrCF4KkPmKUZsVjb-0-2d7b3620e8e0457ea06dca8f23432553)
图1-49
1.4.7 VSCode的安装
从Visual Studio官方网站下载安装包,读者可以自行修改安装时的安装目录或选项,如图1-50所示。这个安装包非常小,启动非常快。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_56_2.jpg?sign=1738857658-VBxvF5qqwTtES4a5biv3z0lkEHvCpIsn-0-c98c88d09c5b4e4462e1941007be1f41)
图1-50
安装完之后会检测系统语言,并提示安装中文扩展,如果没有显示这个提示,则可以自行安装,如图1-51所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_57_1.jpg?sign=1738857658-5JD9urnVN66JRbKByAtsKyXODPgVia2U-0-20aa4e4dd75da30676f0e33f172454bd)
图1-51
1.4.8 VSCode的配置
一般要安装两个插件:一个是官方推出的Python扩展,在安装这个插件之后,Python的编辑、自动补全、代码提示、跳转、运行、调试等功能都能完整支持,可以像IDE一样开发Python程序,如图1-52所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_57_2.jpg?sign=1738857658-bAGc9KOr7VccDk34ei6iMHfWsnbZ1yLl-0-84a5c21a203d5b360a6d327b34d43c72)
图1-52
另一个是Qt扩展。它支持.qml、.qss、.ui等文件的语法高亮,基于PyQt或PySide把.ui文件或.qrc文件编辑成.py文件,是开发PyQt/PySide程序的利器,如图1-53所示。前面已经通过全局方式搭建了Python环境和PySide/PyQt环境,VSCode会自动识别它们,不需要额外配置。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_58_1.jpg?sign=1738857658-sY3V76D87W2ly1TREYJiFMmrKn06Ky8Q-0-ae983df48280ce3d45d679064f584c15)
图1-53
1.4.9 VSCode的基本使用
1.运行与调试
按照如图1-54所示的步骤运行与调试VSCode。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_58_2.jpg?sign=1738857658-C2lB64eNtbo3uiUU3n96OFRXUWgam5ap-0-0d6a658b12a3a28508699f42a1721797)
图1-54
2.调试功能的细节
VSCode的调试功能的细节如图1-55所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_59_1.jpg?sign=1738857658-jByrQbwFaBmYIRmOdePu6Gn08mBOfkKm-0-79cd4daf0dcc7e16b901fceeda3ad2c0)
图1-55
3.PyQt/PySide工具的使用
在安装好Python插件和Qt for Python插件之后,计算机会自动识别Python环境,右击.ui文件,在弹出的快捷菜单中选择Compile Form(Qt Designer UI File) into Qt for Python File命令,此时可以生成对应的.py文件,文件在.qt_for_python\uic目录下,如图1-56所示。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_59_2.jpg?sign=1738857658-aAwPniCuljJubwkDBoGkCGtOe4Aw2X5N-0-f0ebc979096a005d96504e01944e29f9)
图1-56
4.自定义PyQt/PySide工具
搭建好本地Python环境和PySide 6环境之后,VSCode会被自动检测并使用,可以在settings.json文件中自定义其他路径。在“设置”对话框中,可以通过如图1-57所示的方式打开settings.json文件。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_60_1.jpg?sign=1738857658-CCPKxV6C8OzMNkLMmCzYMpH8bgqLyNTk-0-20890f990cc2bea0a09500cb3f95a2b2)
图1-57
添加了如下自定义设置:
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_60_2.jpg?sign=1738857658-gAG5mESMHYcla2yXW9MBqVBcsbqM6OUV-0-e22c4ccdca1627d094bffbd63cbc37c5)
5.使用其他Python环境
如果要切换到其他Python环境,如虚拟环境,则可以按照如图1-58所示的步骤操作。
![](https://epubservercos.yuewen.com/7E60F4/25638742209049106/epubprivate/OEBPS/Images/44525_60_3.jpg?sign=1738857658-7bzkL0zjyFzVDRsL3m2R8qM5sl9En0YR-0-be1a21e95b370a24f722c7c782b18d57)
图1-58