Fluent-Qt

Qt Widgets 的 Fluent UI 组件库

提供输入、导航、表格与图表等常用控件,内置深浅主题与流畅动画,轻松构建跨平台桌面界面。

C++17 Qt 5.15+ / 6.2+ MIT

Python / PySide6 Python 项目可通过 PySide6 使用同一套控件 pip install FluentQt Gallery
Windows 下开启 3D 与 Mica 的 Fluent-Qt Gallery Home 实际截图,展示控件分类和示例
UI 运行时
Qt Widgets
Qt 支持
5.15+ / 6.2+
工具链
CMake + C++17
运行平台
Windows / macOS / Linux / Web

03 / CHECKBOX

属性动态预览

在支持属性预览的组件页,可以调节真实 Qt 控件的属性,查看效果,并复制对应的 C++ 或 PySide6 代码。

CheckBox 属性面板显示已勾选的复选框和生成的 C++ 代码。

04 / GUI SKILL

AI 辅助构建界面

  • 工程结构生成分层清晰的 C++ 或 PySide6 项目骨架
  • 组件选型匹配合适的 Fluent 控件、主题与字号
  • 实时预览先在 Live Scene 里边改边看,再编译确认最终效果
  • 自动检查检查深浅主题、窄窗口布局与无障碍问题
参考实现 DeepSeek Desktop
C++ · FluentQt
使用 build-fluentqt-gui 构建的 DeepSeek Desktop 原生桌面参考界面

任务分组、运行时间线、输入与 Light / Dark 主题。

FluentQt 独立实现,非 DeepSeek 官方应用。

上游项目

05 / QUICK START

快速接入

将右侧 CMake 配置加入工程即可接入;同样支持 add_subdirectory 与 find_package。

  • 保留现有 Widgets 工程与事件循环
  • 核心库只依赖 Qt Widgets
  • Qt 5 与 Qt 6 共用同一套接口
CMakeLists.txt
# Add Fluent-Qt to your existing project
include(FetchContent)

FetchContent_Declare(
  fluentqt
  GIT_REPOSITORY https://github.com/calvinhxx/Fluent-Qt.git
  GIT_TAG v1.12.1
  GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)

target_link_libraries(
  my_app PRIVATE FluentQt::FluentQt
)

06 / SPATIAL · 可选 3D 扩展

Spatial 3D 透视视图

把现有 QWidget 界面放进 SpatialView,为卡片加上 3D 透视、旋转与景深;普通 2D 应用无需开启。

  • 控件不必重写

    保留原有布局、信号槽与数据模型,通过 SpatialItem 控制偏移与旋转。

  • 硬件加速,按需刷新

    桌面端使用 OpenGL,浏览器端使用 WebGL;画面不变时自动复用纹理。

  • 按需启用,保留 2D

    会话启动或视图创建失败时,由应用显示普通 QWidget 布局。

Gallery:Settings → 3D Gallery,再打开 Plugins → Spatial。

SpatialView · C++ / WebAssembly
正在加载示例…

拖动滑块调整视角,移动鼠标查看景深效果。

07 / QMLBRIDGE

嵌入 QML 页面

通过 QmlBridge 在 Qt Widgets 窗口中加载 QML 页面,直接共享业务数据与 Fluent 主题。

Gallery:Plugins → QmlBridge → QmlView。

C++ 片段

if (view->setContextObject(
        "widgetInput", input)) {
    view->load(QUrl("qrc:/Page.qml"));
}

Page.qml

import QtQuick 2.15

Text {
    text: widgetInput.text
    color: fluentTheme.text
    font.family: fluentTheme.fontFamily
}
Widgets 输入框与 QML 文本绑定示例。

08 / POSITIONING

独立封装控件 不止是样式表

每个控件都提供完整的 C++ / Python 接口、交互状态与布局逻辑。

  1. 01

    遵循 Qt Widgets 习惯

    直接沿用现有的信号槽、布局器与事件循环。

  2. 02

    同时兼容 Qt 5 与 Qt 6

    业务代码无需针对 Qt 5 和 Qt 6 写两套调用。

  3. 03

    接入简单干净

    引入 <FluentQt/FluentQt.h> 并链接 FluentQt::FluentQt 即可使用。

09 / DOWNLOAD

下载 Gallery

下载桌面安装包即可离线浏览全部控件;项目集成请使用 CMake 或 pip。

10 / SPONSOR · 赛博投喂

大佬,赏点 Token?

开源用爱发电,奈何 AI 实在太费电。写 C++ 掉的是作者的头发,跑 Agent 烧的是真金白银的上下文。如果 Fluent-Qt 帮你的界面少踩了几个坑、省下了调样式的深夜,不妨投喂一点「赛博猫粮」——哪怕不够大模型塞牙缝,也能让维护者嘴角疯狂上扬。

微信扫一扫 · 立即投喂
维护者的微信收款二维码
支付宝扫一扫 · 立即投喂
维护者的支付宝收款二维码
Ko-fi 扫码 · 手机投喂
维护者的 Ko-fi 主页二维码

直接在 Ko-fi 打开 ↗

手机端冲浪?截屏后去微信或支付宝「扫一扫」里从相册召唤即可。

纯属自愿投喂,仅用于补充咖啡因与 Token,不解锁催更特权或付费服务(但会收获作者在心里的疯狂感谢)。 正经支持说明

Fluent-Qt 的 Ko-fi 美元打赏面板

支持 PayPal 与银行卡;按 Esc 关闭,或 直接在 Ko-fi 打开 ↗