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所示的一些特征。

访问Eric官网，下载最新的Windows系统下的Eric 7安装包。

截至本书成书时，Eric的最新版本为7-22.2，如图1-26所示。

准备好安装环境之后，就可以开始安装Eric 7。在下载完安装包之后先对其进行解压缩，然后进入解压缩目录，双击install.py文件开始安装Eric 7，或者在命令行输入python install.py，使用方式如图1-27所示。

安装完成之后，会在桌面生成快捷方式eric7（Python3.9），其目标路径为D:\miniconda3\Scripts\eric7.cmd，如图1-28所示。

1.4.2 Eric 7的相关配置

Python环境是系统默认的，可以被IDE识别到，因此不需要进行额外的配置，如果读者有其他需求则可以根据自己的需求进行其他设置。

打开Eric 7，选择setting→show external tool命令，可以看到，PySide 6/PyQt 6的环境已经被识别到，如图1-29所示，Qt的各种工具都能够被检测到。

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。

（2）切换到第2个选项，双击testFirst.ui文件，通过可视化的方式创建GUI文件，如图1-31所示。

双击testFirst.ui文件，对应的cmd命令行如下：

先保存编辑完的.ui文件，右击testFirst.ui文件，在弹出的快捷菜单中选择Compile form命令，如图1-32所示，编译文件，把testFirst.ui文件转换为Ui_testFirst.py文件。

这一步对应的cmd命令行如下：

可以看到，此时更新了Ui_testFirst.py文件。

（3）切换到第3个选项，进入资源管理界面，可以看到.qrc文件，即资源管理文件，里面存储的是图片与引用路径信息。右击resource.qrc文件，在弹出的快捷菜单中选择Compile resource命令，如图1-33所示，这样就可以把resource.qrc文件编译成resource_rc.py文件。

这一步对应的cmd命令行如下：

可以看到，此时更新了resource_rc.py文件。

需要注意的是，由于PyQt 6放弃了对资源的支持，即不会提供pyrcc6.exe工具，因此不会显示如图1-33所示的界面。另外，使用PyQt 6运行这个案例的demo不会显示图片。

（4）切换到第1个选项，选中testFirst.py文件，先单击“运行”按钮（或按快捷键F2），再单击PushButton按钮，就会弹出如图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是工程文件夹路径。

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所示。

可以从官方网站下载PyCharm，在下载页面中选择Community版本，如图1-37所示。

安装完PyCharm之后，会在桌面创建快捷方式，笔者创建的快捷方式的名称为PyCharm Community Edition 2021.3.2，打开这个工具，要新建一个Project需要打开如图1-38所示的窗口。

进入PyCharm主程序界面，选项默认都是英文的，可以通过安装插件对选项进行汉化。选择File→Setting命令，打开Settings对话框，下载Chinese插件并应用，重启后即可进入中文界面，如图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文件，以及快速查看帮助等。

1.外部工具的使用

使用这些外部工具非常简单，具体的使用方法和执行效果如图1-41所示。

由此可知，PySide 6/PyUIC这个外部工具实际上执行的是如下所示的cmd命令：

2.配置PySide6/PyUIC

创建外部工具的步骤如图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所示的对话框，选择要打开的文件夹，设置完成后单击“创建”按钮。

在弹出的提示框中单击“从现有的源创建”按钮，如图1-44所示。

在打开的界面中可以对本书的源代码进行编辑操作，如图1-45所示。

2.运行文件

选择“运行”→“运行”命令即可启动文件，在第一次启动之后就可以使用窗口右上角的快捷方式，主要包括“运行”和“调试”两种快捷方式，如图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文件。

5.使用其他Python环境

如果想要使用其他Python环境，如虚拟环境，则可以在如图1-49所示的“设置”对话框中进行修改。

1.4.7 VSCode的安装

从Visual Studio官方网站下载安装包，读者可以自行修改安装时的安装目录或选项，如图1-50所示。这个安装包非常小，启动非常快。

安装完之后会检测系统语言，并提示安装中文扩展，如果没有显示这个提示，则可以自行安装，如图1-51所示。

1.4.8 VSCode的配置

一般要安装两个插件：一个是官方推出的Python扩展，在安装这个插件之后，Python的编辑、自动补全、代码提示、跳转、运行、调试等功能都能完整支持，可以像IDE一样开发Python程序，如图1-52所示。

另一个是Qt扩展。它支持.qml、.qss、.ui等文件的语法高亮，基于PyQt或PySide把.ui文件或.qrc文件编辑成.py文件，是开发PyQt/PySide程序的利器，如图1-53所示。前面已经通过全局方式搭建了Python环境和PySide/PyQt环境，VSCode会自动识别它们，不需要额外配置。

1.4.9 VSCode的基本使用

1.运行与调试

按照如图1-54所示的步骤运行与调试VSCode。

2.调试功能的细节

VSCode的调试功能的细节如图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所示。

4.自定义PyQt/PySide工具

搭建好本地Python环境和PySide 6环境之后，VSCode会被自动检测并使用，可以在settings.json文件中自定义其他路径。在“设置”对话框中，可以通过如图1-57所示的方式打开settings.json文件。

添加了如下自定义设置：

5.使用其他Python环境

如果要切换到其他Python环境，如虚拟环境，则可以按照如图1-58所示的步骤操作。