本页内容

开发Qt for Python 应用程序

借助 Qt for Python,您可以在 Python 应用程序中使用 Qt 6 API。使用 PySide6 模块即可访问各个 Qt 模块,例如 Qt CoreQt GUI以及 Qt Widgets

以下各节介绍了如何使用Qt Creator 进行Qt for Python 开发:

有关使用Qt for Python 进行开发的更多信息(包括限制),请参阅 Qt for Python

设置 PySide6

Qt Creator 运行PySide6项目的推荐方法是为每个项目单独安装PySide6。当您首次打开项目的.py 文件时,Qt Creator 会提示您执行此操作。

提示安装 PySide6 和 Python 语言服务器

此外,Qt Creator 还会提示您安装Python 语言服务器,该服务器提供代码补全和注释等功能。选择Install 以安装 PySide6 和语言服务器。

创建Qt for Python 应用程序

使用向导创建Qt for Python 应用程序项目。 向导会生成一个项目文件 `pyproject.toml`,其中列出了 Python 项目中的文件及其他配置。此外,还会生成包含一些模板代码的 `.py ` 文件,以及用于存储生成的 PySide 版本代码的 `requirements.txt ` 文件。另外,基于控件的用户界面向导会生成包含 `Qt Widgets Designer` 表单的 `.ui ` 文件,而 `Qt Quick ` 应用程序向导会生成导入 `Qt Quick ` 控件的 `.qml ` 文件。

Window 向导会在源文件中添加代码,但不生成 UI 文件。

Empty 向源文件添加代码,但不会添加任何类,因此您需要自行添加并实例化这些类。

pyproject.toml 文件是基于TOML的配置文件,取代了之前使用的.pyproject 配置文件。您仍然可以打开和使用.pyproject 文件,但我们建议您在新项目中选择pyproject.toml 文件。

选择 Python 版本

您在“Projects >Build & Run ”中为项目选择的套件将决定要使用的 Python 版本。

“编辑代码”工具栏会显示当前的 Python 版本。

编辑模式工具栏上的 Python 版本

若要使用其他 Python 版本,请为该项目激活另一个套件。

为 Python 创建套件

Qt Creator 会自动将所有能找到的 Python 版本添加到“Preferences >Python >Interpreters ”中的 Python 版本列表中。它会为不在虚拟环境中的全局 Python 版本生成套件。

Python 首选项中的“解释器”选项卡

管理 Python 版本

您可以添加和移除 Python 版本,并清理已卸载但仍出现在列表中的 Python 版本引用。

若要在打开不属于任何项目的.py 文件时使用所选的Python版本,请选择“Make Default ”。

将虚拟环境用作套件

若要将虚拟环境用作套件,请在“Interpreters ”中选中该环境,然后选择“Generate Kit ”。

更改 Python 套件的调试器

要更改 Python 套件的调试器,请在“Preferences ”>“Kits ”中选中该套件。然后,在“Debugger ”字段中,从可用调试器列表中选择要使用的调试器。

套件偏好设置

使用 Python 交互式 shell

您可以在“Edit ”模式下编写 Python 代码。在工具栏上选择“REPL ”,即可在“Terminal”视图中启动Python 交互式 shell

终端视图中的 Python 命令行

要启动交互式 shell 并将当前文件作为模块导入,请选择“REPL Import File ”。若要同时导入该文件中的所有函数,请选择“REPL Import * ”。

另请参阅 《教程:Qt Widgets 与 Python》、《教程:Qt Widgets UI 与 Python》、《教程:Qt Quick 与 Python》以及《为项目激活套件》。

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.