前言

《Qt for Python 学习笔记》系列第一篇文章（Qt for Python学习笔记—简介 ）对 Qt for Python 进行了介绍。

本文是本系列第二篇文章，接着通过图文方式详细介绍如何在 Window 平台上，结合使用 Python、PySide6、Visual Studio Code 及 Python 相关扩展，来搭建一个可进行 Python GUI 应用程序开发的集成开发环境，供各位 Qt for Python 的初学者们参考。

注：本系列将会以 PySide6 为例进行介绍，原则上同样适用于 PyQt6。

1. 开发环境目标

本文的 Python GUI 应用程序集成开发环境目标参考如下：

注：最基本的开发环境只需安装 Python 语言 和 PySide6（或 PyQt6）模块即可，无需安装有些庞大的 Qt 。

2. 安装 Python

2.1 下载

Python 是一款开源软件，可以从其官网下载 Python 安装文件。

根据操作系统和架构情况选择下载相应的 Python 安装文件（如：python-3.8.7-amd64.exe）。

注：最新的 Python 3.9 已经不再支持 Windows 7。本文因受 Windows 7 系统所限，安装的是 Python 3.8.7 版本；如果读者是 Windows 10 系统，则建议安装最新的 Python 3.9.1 版本。

2.2 安装

以管理员身份运行 Python 安装文件，按照提示完成安装。具体过程如下图示：

Step1：执行安装文件，进入【Install Python】向导窗口，选择安装方式（默认安装或者自定义安装）以及勾选安装选项。

注1：本文选择的安装方式是“自定义安装”（后续可以自定义安装路径）。

注2：强烈建议勾选“Add Python 3.8 to PATH”，即添加 Python 到环境变量。否则，安装结束后需要自己手动配置 Python 环境变量。

Step2：点击【Customize installation】，在【Optional Features】向导窗口下勾选需要安装的功能选项。

注：建议全部勾选。其中：

——pip 是 Python 的包管理工具程序，可以使用 pip 方便地下载和安装各种第三方 Python 包（如 PySide6 或 PyQt6 等）。

——tcl/tk and IDLE 会安装 tkinter 模块和 Python IDEL 开发环境。

Step3：点击【Next】按钮，在【Advanced Options】向导窗口下勾选需要安装的高级选项，然后确定安装路径。

注1：务必要勾选上【Add Python to environment variables】选项。

注2：安装路径可以根据需要是选择缺省路径还是自定义一个安装路径（本人倾向于自定义路径，如 C:\Develop\Python）。

注3：其他选项建议默认即可。

Step4：点击【Install】按钮后进入【Setup Progress】向导窗口，执行真正的安装，耐心等待。

Step5：安装结束时进入【Setup was successful】向导窗口，提示安装成功，点击【Close】按钮关闭安装窗口。

安装结束后，Python 被安装到 C:\Develop\Python 目录下，重点目录相关说明如下：

——C:\Develop\Python 下包含有 Python 的主程序文件 python.exe 和 pythonw.exe；

——C:\Develop\Python\Scripts 下则存放 Python 的工具软件（如 pip.exe 等）和第三方包（或模块）中的可执行文件（如安装 PySide6 后，会在此目录下增加4个 PySide6 相关的可执行文件）。

——C:\Develop\Python\Lib 下存放的是 Python 的内置标准库。

——C:\Develop\Python\Lib\site-packages 下存放的是后续安装的第三方包（或模块）。

——C:\Develop\Python\Doc 下存放的是 chm 格式的 Python 文档。

2.3 验证

在 cmd 控制台或其他终端上输入 python 命令，若出现如下提示，则表示安装成功：

 Windows PowerShell
 Copyright (C) 2016 Microsoft Corporation. All rights reserved.
 
 C:\> python
 Python 3.8.7 (tags/v3.8.7:6503f05, Dec 21 2020, 17:59:51) [MSC v.1928 64 bit (AMD64)] on win32
 Type "help", "copyright", "credits" or "license" for more information.
 >>>

3. 安装 PySide6

3.1 下载和安装

可在 PyPI 网站上找到最新版本的 PySide6 模块的信息。

通常可在终端控制台通过执行 pip 命令完成 PySide6 模块的下载和安装：

 C:\> pip install PySide6
 Collecting PySide6
   Downloading PySide6-6.0.0-6.0.0-cp36.cp37.cp38.cp39-none-win_amd64.whl (62.4 MB)
      |████████████████████████████████| 62.4 MB 28 kB/s
 Collecting shiboken6==6.0.0
   Downloading shiboken6-6.0.0-6.0.0-cp36.cp37.cp38.cp39-none-win_amd64.whl (2.3 MB)
      |████████████████████████████████| 2.34 MB 28 kB/s
 Installing collected packages: shiboken6, PySide6
 Successfully installed PySide6-6.0.0 shiboken6-6.0.0

注1：在 PySide6 安装过程中会自动安装所依赖的 shiboken6 模块。

注2：如果直接连接 PyPI 服务器速度比较慢，导致安装失败，则可以使用国内镜像网站安装，如使用清华大学镜像网站的指令为：

 C:\> pip install PySide6 -i https://pypi.tuna.tsinghua.edu.cn/simple

PySide6 安装结束后，会在 PySide6 安装路径（如： C:\Devlelop\Python\Scripts）下增加下面4个 PySide6 相关的可执行文件：

注：因路径“C:\Devlelop\Python\Scripts”已经被添加到了 Windows 的 PATH 环境变量里，故上述程序在终端窗口里可以直接运行。

同时在 C:\Develop\Python\Lib\site-packages 目录下新增 PySide6 模块和 shiboken6 模块。

下图是 PySide6 模块的目录文件结构：

如果需要卸载 PySide6 模块了，则可以在终端控制台通过执行 pip 命令卸载 PySide6 模块（注意将 shiboken6 模块一并卸载了）：

C:\> pip uninstall shiboken6 PySide6

3.2 验证

在 PySide6 安装完成后启动 Python 解释器：

——首先导入 PySide6 模块，看是否有异常抛出？ （有异常，则表示安装存在问题）

——接着输入 PySide6.__version__ 后回车，若出现如下信息，则表示安装成功。

 Python 3.8.7 (tags/v3.8.7:6503f05, Dec 21 2020, 17:59:51) [MSC v.1928 64 bit (AMD64)] on win32
 Type "help", "copyright", "credits" or "license" for more information.
 >>> import PySide6
 >>> PySide6.__version__
 '6.0.0'

4. 安装 PyQt6 （可选）

4.1 安装 PyQt6

可在 PyPI 网站上找到最新版本的 PyQt6 模块的信息。

通常可在终端控制台通过执行 pip 命令安装 PyQt6 模块：

 C:\> pip install PyQt6
 Collecting PyQt6
   Downloading PyQt6-6.0.0-6.0.0-cp36.cp37.cp38.cp39-none-win_amd64.whl (46.5 MB)
      |████████████████████████████████| 46.5 MB 28 kB/s
 Collecting PyQt6-sip<14,>=13.0
   Downloading PyQt6_sip-13.0.0-cp38-cp38-win_amd64.whl (57 kB)
      |████████████████████████████████| 57 kB 727 kB/s
 Installing collected packages: PyQt6-sip, PyQt6
 Successfully installed PyQt6-6.0.0 PyQt6-sip-13.0.0

注1：在 PyQt6 安装过程中会自动安装所依赖的 PyQt6-sip 模块。

注2：如果直接连接 PyPI 服务器速度比较慢，导致安装失败，则可以使用国内镜像网站安装，如使用清华大学镜像网站的指令为：

 C:\> pip install PyQt6 -i https://pypi.tuna.tsinghua.edu.cn/simple

PyQt6 安装结束后，会在 PyQt6 安装路径（如：C:\Devlelop\Python\Scripts）下增加如下2个 PyQt6 相关的可执行文件：

注：因路径“C:\Devlelop\Python\Scripts”已经被添加到了 Windows 的 PATH 环境变量里，故上述程序在终端窗口里可以直接运行。

同时在 C:\Develop\Python\Lib\site-packages 目录下新增 PyQt6 模块和 PyQt6-sip 模块。

注：如果需要卸载 PyQt6 模块了，则可以在终端控制台通过执行 pip 命令卸载 PyQt6 模块（注意将 PyQt6-sip 模块一并卸载了）：

 C:\> pip uninstall PyQt6-sip PyQt6

4.2 验证

在 PyQt6 安装完成后启动 Python 解释器：

——首先导入 PyQt6 模块，看是否有异常抛出？ （有异常，则表示安装存在问题）

——接着输入 PyQt6.__version__ 后回车，若出现如下信息，则表示安装成功。

 Python 3.8.7 (tags/v3.8.7:6503f05, Dec 21 2020, 17:59:51) [MSC v.1928 64 bit (AMD64)] on win32
 Type "help", "copyright", "credits" or "license" for more information.
 >>> import PyQt6
 >>> PyQt6.__version__
 '6.0.0'

实际上，在完成 Python 和 PySide6（或 PyQt6）的安装后，就已经搭建完成了一个可用于进行 Python GUI 应用程序开发的最基本开发环境，可以使用 Python IDLE 来编辑、调试代码和运行程序。（无需安装有些庞大的 Qt ，可以大大节省硬盘空间。）

当然上述最基本开发环境对于大多数开发者而言，毕竟还不是很方便，因此可以在最基本开发环境基础上再增加一个超级强大好用的代码编辑器 Visual Studio Code，并安装上适用于 Python 的相关扩展，这样就可以完成搭建一个可用于进行 Python GUI 应用程序开发的集成开发环境。

5. 安装 Visual Studio Code

5.1 下载

Visual Studio Code 是一款开源软件，可以从其官网下载安装软件：

根据机器配置选择相应最新版本的安装文件（如：Windows 平台上64位的 System 安装文件: VSCodeSetup-x64-1.52.1.exe）

注：在官网下载 Visual Studio Code 时，Windows 版本提供了 System Installer 和 User Installer 两个安装包。它们的区别在于：System Installer 安装到所有用户的程序里；User Installer 只安装到当前用户下。User Installer 安装包对系统权限低，使用中可能会有意想不到的麻烦；System Installer 则能畅通无阻。为了避免不必要的麻烦，建议下载 System Installer。

5.2 安装

Visual Studio Code 的安装非常简单，按照向导提示逐步点【下一步】即可完成，相关安装过程如下：

安装成功后界面如下：

6. 安装适用于VSCode的Python扩展

6.1 扩展简介

该扩展具有对 Python 语言的丰富支持，包括诸如：智能提示（IntelliSense）、语言分析（linting）、调试（debugging）、代码导航（code navigation）、代码格式化（code formatting）、代码重构（refactoring）、单元测试（unit tests）、 Jupyter notebook 支持等等。

6.2 扩展安装

打开 Visual Studio Code，在扩展商店中搜索 Python 关键字，然后安装列示在第1个的那个扩展（下载量最大，微软发布的），如下图示：

6.3 扩展配置

Python 扩展通常情况下无需配置即可正常使用。

7. 安装适用于VSCode的Pylance扩展（可选）

7.1 扩展简介

该扩展可与 Visual Studio Code 中的 Python 扩展一起使用，以提供高性能、功能丰富的 Python 语言支持。Pylance 使用 Pyright，可以为 Python IntelliSense 体验提供丰富的类型信息，从而帮助您更快地编写更好的代码。

7.2 扩展安装

打开 Visual Studio Code，在扩展商店中搜索 Pylance 关键字，然后安装列示出来的唯一扩展（微软发布的），如下图示：

7.3 扩展配置

安装完 Pylance 扩展后，当通过 Visual Studio Code 打开一个 Python 文件（.py）时，Pylance 扩展将被激活。

如果系统提示将 Pylance 设置为默认语言服务器时，建议选择“是”，这将更新首选项；也可以手动通过文本编辑器将 "python.languageServer": "Pylance" 添加到 settings.json 文件中来完成配置。

更多信息请参见之前的文章《Visual Studio Code 扩展介绍 - Pylance》。

8. 安装适用于VSCode的Qt for Python扩展（可选）

虽然上面的集成开发环境已经可以很好地实现开发 Python GUI 应用程序的目标了，但是还可以在此基础上把 PySide6 模块下的相关工具软件（pyside6-uic.exe、pyside6-rcc.exe、pyside6-lupdate.exe等）集成到 Visual Studio Code 中，这样界面设计更有效率，相关操作也更为友好。

8.1 扩展简介

Qt for Python 是 Visual Studio Code 上的一款针对 PyQt5 和 PySide2 的扩展。

注：Qt for Python 扩展虽然是针对 PyQt5 和 PySide2 的，但同样适用于 PyQt6 和 PySide6 。

Qt for Python 扩展主要特性：

(1) 支持对 Qt 标记语言（*.qml）、Qt 模块定义文件（*.qmldir）、Qt 样式表（*.qss）、Qt 语言翻译（*.qt.ts）、资源收集文件（*.qrc）、Qt 设计表单（*.ui）、Qt Creator 用户设置（*.pro.user）的语法高亮显示和代码片段；qmake 的语法高亮；

(2) 可通过右键菜单项【New Form (Qt Designer UI File)】调用 Qt Designer 工具创建一个新窗体（Form）；

(3) 可通过右键菜单项【Edit Form (Qt Designer UI File)】调用 Qt Designer 工具打开一个已有 窗体（Form） 进行编辑；

(4) 可通过右键菜单项【Edit Linguist Translation File)】调用 Qt Linguist 工具进行编辑；

(5) 可通过右键菜单项【Release Qt Linguist Translation File to QM File】调用 Qt Release 工具将翻译发布到 .qm 文件；

(6) 可通过右键菜单项【Compile Form (Qt Designer UI File) into Qt for Python File)】调用 PySide6-uic.exe 将 UI 文件转换成为 Python 类文件；

(7) 可通过右键菜单项【Update Qt Linguist Translation File form Qt for Python】调用 pyside6-lupdate.exe 更新 *.qt.ts 翻译文件；

(8) 可通过右键菜单项【Compile QRC (Qt Resource File) into Qt for Python File)】调用 PySide6-rcc.exe 将 QRC 文件转换成为 Python 类文件；

(9) 预览QML文件

8.2 扩展安装

打开 Visual Studio Code，在扩展商店中搜索 PySide2 关键字，然后安装列示的下载量最大的那个扩展（Qt for Python），如下图示：

8.3 扩展配置

安装好 Qt for Python 扩展后，进入【设置】窗口，选择【用户】->【扩展】->【Qt for Python】，在右侧的“Qt for Python”区域进行相应配置（如下图示）：

相关配置参考如下（请注意：需结合 PySide6 实际安装路径加以相应修改）：

 #Qt For Python > Path: Designer
 C:\Develop\Python\Lib\site-packages\PySide6\designer.exe
 #Qt For Python > Path: Linguist
 C:\Develop\Python\Lib\site-packages\PySide6\linguist.exe
 #Qt For Python > Path: Lrelease
 C:\Develop\Python\Lib\site-packages\PySide6\lrelease.exe -qm .\out.qm
 
 #Qt For Python > Path: PyLupdate
 pyside6-lupdate.exe -ts "${fileDirname}\\${fileBasenameNoExtension}.qt.ts"
 #Qt For Python > Path: Pyrcc
 pyside6-rcc.exe -o "${fileDirname}\\${fileBasenameNoExtension}.py"
 #Qt For Python > Path: Pyuic
 pyside6-uic.exe -o "${fileDirname}\\${fileBasenameNoExtension}.py"

自此，已经成功在 Window 平台上，结合使用 Python、PySide6、Visual Studio Code 及 Python 相关扩展，搭建完成了一个可进行 Python GUI 应用程序开发的集成开发环境。接下来，我们就可以进入到 Python GUI 应用程序开发之旅了。

结束语

本系列介绍如何在 Python 中使用 Qt for Python 进行 GUI 应用程序开发。

本文是《Qt for Python 学习笔记》系列第二篇，图文方式详细介绍了如何在 Window 平台上，结合使用 Python、PySide6、Visual Studio Code 及 Python 相关扩展，来搭建一个可进行 Python GUI 应用程序开发的集成开发环境。

接下来会对如何用基本开发环境来开发一个简单的 Qt for Python 入门应用程序进行介绍，敬请期待！

希望本文能对您有所帮助！若文中存在疏忽不足或错误，还请不吝赐教！