Repolode
提交项目
alfiopuglisi

alfiopuglisi/guietta

一个用于快速搭建简单桌面图形界面的 Python 库，底层基于 Qt。

在 GitHub 查看官网
Star
1,953
Fork
93
未关闭 Issue
13
最近提交
12天前

这是什么？

Guietta 让 Python 开发者通过嵌套列表描述界面布局来构建桌面图形界面。列表中的每个单元格会成为标签、文本框或按钮等控件，占位符则用于留空的网格位置。事件处理函数通过 `with gui.按钮名:` 语句绑定，因此一个简单的计算器只需几行代码即可实现。

除基础表单外，该库还支持与 matplotlib、pyqtgraph 集成以实现事件驱动的绘图，可用列表和字典在标签中展示多列数据，并支持多窗口。异常处理行为可以自定义，长时间运行的操作也可以放到后台执行。任何继承自 QWidget 的 Qt 控件（包括自定义控件）都能直接放入布局，原生 Qt 信号与槽机制同样可用。

默认使用 PySide2 绑定，在无法安装 PySide2 的系统上可回退到 PyQt5。项目通过 pip 安装。

核心功能

  • 01用嵌套列表描述界面布局，空白位置用占位符表示。
  • 02通过 `with gui.按钮名:` 语句简洁地绑定事件处理函数。
  • 03与 matplotlib、pyqtgraph 集成，实现事件驱动的绘图。
  • 04支持多窗口，并可自定义异常处理行为。
  • 05可直接使用任何继承自 QWidget 的 Qt 控件，包括自定义控件。

适用场景

  • 快速搭建计算器、数据录入表单等小型工具。
  • 为数据分析脚本添加简单的交互式绘图窗口。
  • 无需深入学习完整 Qt API，即可快速原型化桌面界面。

快速上手

  1. 1

    使用 pip 安装 guietta

    pip install guietta
  2. 2

    创建包含示例 GUI 代码的 Python 文件并调用 gui.run() 运行

使用前须知

  • 默认使用 PySide2 Qt 绑定，部分系统（如较旧的 Mac 和树莓派）可能无法安装，此时需要手动安装 PyQt5。

收录于专题

桌面图形界面应用与框架

标签

#gui#qt#pyside2#pyqt5#desktop-app#python-gui#matplotlib

常见问题

guietta 是什么？
一个用于快速搭建简单桌面图形界面的 Python 库，底层基于 Qt。 Guietta 让 Python 开发者通过嵌套列表描述界面布局来构建桌面图形界面。列表中的每个单元格会成为标签、文本框或按钮等控件，占位符则用于留空的网格位置。事件处理函数通过 `with gui.按钮名:` 语句绑定，因此一个简单的计算器只需几行代码即可实现。
guietta 可以免费使用吗？用的什么许可证？
guietta 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
guietta 还在维护吗？
活跃维护中。guietta 最近一次提交是在 2026年10月27日。
guietta 适合用来做什么？
快速搭建计算器、数据录入表单等小型工具。 为数据分析脚本添加简单的交互式绘图窗口。 无需深入学习完整 Qt API，即可快速原型化桌面界面。
guietta 怎么安装和运行？
使用 pip 安装 guietta: pip install guietta 创建包含示例 GUI 代码的 Python 文件并调用 gui.run() 运行
在哪里获取 guietta？
源代码和安装说明在 GitHub 上：https://github.com/alfiopuglisi/guietta

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目