桌面应用UI组件【免费下载链接】PyQt-Fluent-WidgetsA fluent design widgets library based on C Qt/PyQt/PySide. Make Qt Great Again.项目地址https://gitcode.com/gh_mirrors/py/PyQt-Fluent-Widgets点击查看免费下载本指南以 docs/source/quick-start.rst 为骨架系统讲解 PyQt-Fluent-Widgets 的两种安装方式精简版与 full 完整版及背后的依赖差异、多 Qt 绑定分支的选型注意事项并结合仓库源码与示例目录给出可验证的安装、运行与排错步骤。读完本文你将能正确完成包安装、版本验证并成功运行 examples 目录下的任意示例程序。安装前的版本认知PyQt-Fluent-Widgets 是一个基于 PyQt5 的 Fluent Design 风格控件库见 setup.py 中descriptionA fluent design widgets library based on PyQt5。当前仓库对应的发布版本为1.11.3这一版本号同时记录在 setup.py 与 qfluentwidgets/init.py 中__version__ 1.11.3安装完成后可直接从包内读取。在安装之前需要明确一点该库的导入包名统一为qfluentwidgets与 PyQt5 / PySide2 / PySide6 / PyQt6 的绑定版本无关。这一点直接决定了官方文档中的警告切勿在同一环境中同时安装多个 Fluent Widgets 发行包详见后文冲突警告一节。安装两种发行版本及其差异quick-start 文档给出两种安装命令区别在于是否包含AcrylicLabel等依赖科学计算能力的完整特性精简版litepip install PyQt-Fluent-Widgets -i https://pypi.org/simple/精简版不包含AcrylicLabel。查阅 qfluentwidgets/components/widgets/acrylic_label.py 可知其底层机制AcrylicLabel依赖qfluentwidgets.common.image_utils中的gaussianBlur函数而该函数基于scipy.ndimage.filters.gaussian_filter与 Pillow见 qfluentwidgets/common/image_utils.py。当这些可选依赖缺失时模块通过try/except ImportError将isAcrylicAvailable置为False并降级为直接返回原始QPixmap的占位实现同时checkAcrylicAvailability()会发出警告提示AcrylicLabel is not supported in current qfluentwidgets, use pip install PyQt-Fluent-Widgets[full] to enable it.因此精简版适合不需要亚克力Acrylic模糊特效的普通界面开发。完整版fullpip install PyQt-Fluent-Widgets[full] -i https://pypi.org/simple/full 版通过extras_require追加了三个依赖见 setup.pyscipy提供高斯模糊等数值计算能力是AcrylicLabel模糊特效的核心pillow负责图像读取与缩放配合scipy完成逐通道高斯模糊gaussianBlur中会对 RGB 三通道分别执行gaussian_filtercolorthief用于从图像中提取主色调DominantColor.getDominantColor供界面配色与动态取色场景使用。这些依赖在 requirements.txt 中也有体现。需要说明的是仓库根目录的 requirements.txt 同时列出了PyQt55.15.0、PyQt5-Frameless-Window0.8.0、darkdetect等基础依赖——darkdetect用于自动检测系统深色/浅色主题以切换 QSS 样式PyQt5-Frameless-Window则为无边框窗口提供底层支持。若你在本地源码方式运行时依赖不齐可参考该文件补齐。版本选择建议只要你的界面中会用到 examples/material/acrylic_label/demo.py 所展示的亚克力标签、或 examples/material 目录下其他 acrylic 系列示例就应选择 full 版否则精简版即可满足大部分常规控件需求。其他 Qt 绑定分支如果使用 PySide2、PySide6 或 PyQt6quick-start 文档明确说明需要切换到对应的代码分支PySide2 分支PySide6 分支PyQt6 分支这是因为当前仓库master/默认分支的源码是基于 PyQt5 编写的控件实现中大量使用PyQt5.QtCore、PyQt5.QtWidgets等导入可参见 qfluentwidgets/components/widgets/acrylic_label.py 的头部导入。不同 Qt 绑定的 API 与信号槽机制存在差异直接混用会导致导入或运行错误。冲突警告不要混装多个发行包Warning不要同时安装 PyQt-Fluent-Widgets、PyQt6-Fluent-Widgets、PySide2-Fluent-Widgets 和 PySide6-Fluent-Widgets因为它们的包名都是qfluentwidgets。这是一个非常关键的实操陷阱。由于四个发行包共享同一个导入名qfluentwidgets混装时 pip 会将后安装的版本覆盖前一个包的文件导致qfluentwidgets下的模块实际来自两个甚至多个不同绑定版本轻则导入报错、重则运行期崩溃。正确的做法是先卸载已有版本再安装目标绑定对应的唯一发行包。例如pip uninstall PyQt-Fluent-Widgets pip install PyQt-Fluent-Widgets[full] -i https://pypi.org/simple/安装后的版本验证安装完成后建议先做一次最小化验证确认包可正常导入、版本正确import qfluentwidgets print(qfluentwidgets.__version__) # 1.11.3qfluentwidgets/__init__.py在导入时会自动加载components、common、window等子包以及内置资源模块from ._rc import resource因此这一条 import 语句同时验证了 QSS 资源、图标资源等依赖链路的完整性。若该语句抛错说明安装源或依赖存在问题可参考下文常见问题排查。运行示例从 examples 目录开始安装完成后即可运行仓库 examples 目录下的任意示例。quick-start 文档以画廊gallery示例为例cd examples/gallery python demo.pygallery 示例内部做了什么阅读 examples/gallery/demo.py 可以看到一个典型的 PyQt5 应用启动流程这也是一切自研应用的模板DPI 缩放处理根据app.common.config中的cfg.dpiScale配置决定启用系统高 DPI 缩放还是手动设置QT_SCALE_FACTOR创建QApplicationapp QApplication(sys.argv)并设置AA_DontCreateNativeWidgetSiblings等属性国际化创建FluentTranslator(locale)并安装界面文案会随系统语言切换仓库内置了中英文等多套翻译资源见 qfluentwidgets/_rc/i18n创建主窗口实例化app.view.main_window.MainWindow并show()最后进入app.exec_()事件循环。更多示例一览除了 gallery仓库还按功能域组织了大量可直接运行的 demo均可采用同样的cdpython demo.py方式运行基础输入examples/basic_input/button/demo.py、check_box、slider 等材质特效examples/material 下的 acrylic 系列需 full 版依赖日期时间examples/date_time 下的日历、时间选择器对话框与浮出层examples/dialog_flyout 下的颜色对话框、消息框、教学提示等导航examples/navigation 下的导航栏、Pivot、分段控件等窗口examples/window 下的无边框窗口、设置界面、启动画面等。每个 demo 都是独立的可执行脚本直接python运行即可无需额外启动参数。常见问题ImportError 与镜像源quick-start 文档特别给出了一个高频问题如果遇到ImportError: cannot import name XXX from qfluentwidgets说明安装的包版本过低请将镜像源替换为 https://pypi.org/simple/ 后重新安装。该问题的成因有两类均可通过换源重装解决版本过旧旧版qfluentwidgets尚未包含示例代码所引用的新控件如新增的TeachingTip、InfoBadge等import 时自然找不到对应名字镜像同步延迟第三方 PyPI 镜像更新滞后导致装到的是过期版本。解决方法是显式指定官方 PyPI 源重装并建议升级到最新版pip install --upgrade PyQt-Fluent-Widgets[full] -i https://pypi.org/simple/小结PyQt-Fluent-Widgets 的快速上手只需三步按绑定版本选对发行包安装精简版或 full 版→ 导入验证版本 → 运行 examples 下的任意 demo。需要特别记住三条原则需要AcrylicLabel等亚克力特效时使用PyQt-Fluent-Widgets[full]否则精简版即可同一环境只允许安装一个 Fluent Widgets 发行包包名均为qfluentwidgets遇到ImportError优先考虑版本过旧或镜像源滞后换用官方源 https://pypi.org/simple/ 重装即可。赞分享桌面应用UI组件【免费下载链接】PyQt-Fluent-WidgetsA fluent design widgets library based on C Qt/PyQt/PySide. Make Qt Great Again.项目地址https://gitcode.com/gh_mirrors/py/PyQt-Fluent-Widgets点击查看免费下载相关推荐PyQt-Fluent-Widgets 快速上手指南安装配置、示例运行与 Fluent Design 组件架构解析PyQt Fluent Widgets 快速上手指南安装配置、示例运行与 Fluent Design 组件架构解析 本篇指南以 PyQt Fluent Wid桌面应用UI组件PyQt-Fluent-Widgets 极速上手从安装到第一个 Fluent 界面仅需 5 分钟PyQt Fluent Widgets 极速上手从安装到第一个 Fluent 界面仅需 5 分钟 你是否还在为 PyQt 界面设计繁琐而烦恼是否想快速开发出桌面应用UI组件INFO-SPIDER 快速上手环境依赖、安装部署与 GUI 运行全指南INFO SPIDER 快速上手环境依赖、安装部署与 GUI 运行全指南 本文以 docs/QuickStart.md https://link.gitcod网页爬虫数据分析数据可视化桌面应用上一篇终极遗传算法入门从生物进化到代码实现的简单指南下一篇Fluent UI数据表格分页控件5步实现完美自定义分页功能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
