桌面应用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），仅供参考
企业数字化 ERP 产品动态
相关推荐
从多模态到具身智能：VLA、World Model与MPC技术路线图 1. 从多模态到具身智能：一条正在收敛的技术主线过去两年，我一直在跟踪多模态和具身智能这两个方向的交叉演进。说实话，2023年之前，这两个领域基本是各玩各的——做多模态的埋头刷VQA、图文检索的榜单，做机器人的继续调… · 2026/9/26 10:14:41
jc 解析 /etc/passwd：将 Linux/macOS 用户账户数据库转为 JSON 的完整指南 开发工具 【免费下载链接】jc CLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. This allows piping of output to tools like jq and simplifying automation scripts.… · 2026/9/26 10:14:41
Bangumi 第三方客户端安装指南：三分钟跑起 bgm.tv 追番应用 Bangumi 第三方客户端安装指南：三分钟跑起 bgm.tv 追番应用 【免费下载链接】Bangumi :electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一个无广告、以爱好为驱动、不以盈利为目的、专门做 ACG 的类似… · 2026/9/26 10:14:35
ANV32AA1WDK66与R7KA8T2LFLCAC：数据快速处理实战指南 这个标题很有意思，乍一看是两串毫无规律的字符，但常年在数据处理这行摸爬滚打的人一眼就能识别出来：这大概率是某套自动化流程里的一对配置标识符，不是 API 访问密钥，就是云端资源实例的唯一编号。任务说得也很明白&am… · 2026/9/26 11:26:06
综科智控以太网IO模块Modbus TCP对接实操指南 前阵子帮一家汽车零部件厂做设备数据采集改造，机柜里要加一批远程IO，方案比选了一圈，最后落在综科智控的以太网IO模块上，上位机通过Modbus TCP协议统一取数，现场四十多个点位不到两天就跑通了。说实话，综科… · 2026/9/26 11:26:06
Atlas 300V 24G推理加速卡实战：从CANN环境到YOLO模型部署 最近被问得最多的就是“Atlas 300V 24G是不是运算加速卡”以及“能不能用它跑YOLO”。问的人多了，我干脆把这段时间在团队内部折腾这套硬件的完整过程整理成一篇实操记录。先说结论：它是运算加速卡，而且就是冲着AI推理这个方向去的࿰… · 2026/9/26 11:26:00
万兆网卡采购避坑指南：从速率标签到确定性交付 1. 为什么“万兆”两个字背后藏着企业网络采购最大的认知陷阱同样是标着“10Gbps”的万兆网卡，A公司花三万块买了四张，B公司用八千块配齐整套，结果上线三天就出现批量丢包、虚拟机频繁断连、备份任务反复超时——最后发现，B公司买… · 2026/9/26 11:25:41
数据挖掘实战中的空气质量预测：从特征工程到模型选型全流程解析 简介：面向数据挖掘初学者与高校相关课程实践者，这份压缩包提供了一套完整的空气质量预测实战方案，基于机器学习算法完成污染数据的建模与分析，可帮助读者快速走通从数据准备到结果输出的完整流程。包体十分紧凑，共3个文… · 2026/9/26 11:25:41
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
