zhiyiYo/PyQt-Fluent-Widgets

这是什么？

核心功能

• 01提供 Fluent 风格的按钮、导航面板、对话框和输入控件。
• 02主版本支持 PyQt5，另有 PySide2、PySide6、PyQt6 分支。
• 03可在 Windows、Linux 和 macOS 上运行。
• 04附带示例 gallery，展示各类组件用法。
• 05完整版安装可启用亚克力效果标签等额外组件。

适用场景

• 用 Python 开发外观现代、接近 Windows 11 风格的桌面应用。
• 为已有的 PyQt 或 PySide 工具添加侧边栏导航布局。
• 快速搭建 Qt 图形界面原型，省去逐个控件美化的工作。

快速上手

1. 1

   从 PyPI 安装 PyQt5 精简版

   pip install PyQt-Fluent-Widgets -i https://pypi.org/simple/
2. 2

   运行 examples 目录中的示例程序

   cd examples/gallery python demo.py

使用前须知

• !采用 GPLv3 许可，仅限非商业用途；商业使用需购买商业许可证。
• !README 提示 PyQt-Fluent-Widgets 及其 PyQt6、PySide2、PySide6 版本包名相同，不能同时安装。
• !PyPI 包基于 PyQt5；使用 PySide2、PySide6 或 PyQt6 需要切换到对应分支。

收录于专题

标签

常见问题

PyQt-Fluent-Widgets 是什么？

基于 PyQt 的 Fluent Design 风格控件库，用于快速构建现代化 Qt 桌面应用界面。 PyQt-Fluent-Widgets 是一个用于构建 Qt 桌面应用的组件库，界面风格参考 Windows 11 的 Fluent Design。它提供导航界面、按钮、对话框、输入控件等开箱即用的组件，开发者无需逐个手动美化 Qt 控件。

PyQt-Fluent-Widgets 可以免费使用吗？用的什么许可证？

PyQt-Fluent-Widgets 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

PyQt-Fluent-Widgets 还在维护吗？

活跃维护中。PyQt-Fluent-Widgets 最近一次提交是在 2026年11月1日。

PyQt-Fluent-Widgets 适合用来做什么？

用 Python 开发外观现代、接近 Windows 11 风格的桌面应用。 为已有的 PyQt 或 PySide 工具添加侧边栏导航布局。 快速搭建 Qt 图形界面原型，省去逐个控件美化的工作。

PyQt-Fluent-Widgets 怎么安装和运行？

从 PyPI 安装 PyQt5 精简版: pip install PyQt-Fluent-Widgets -i https://pypi.org/simple/ 运行 examples 目录中的示例程序: cd examples/gallery python demo.py

在哪里获取 PyQt-Fluent-Widgets？

源代码和安装说明在 GitHub 上：https://github.com/zhiyiYo/PyQt-Fluent-Widgets