一、Flet 是什么？
在过去的很长一段时间里，构建用户界面（UI）往往是 Python 开发者的'短板'。虽然我们有 Tkinter、PyQt、wxPython 等 GUI 工具，但它们或过于陈旧、或依赖庞大的桌面框架，难以适应现代前端的体验。而 Web 前端则需要掌握 HTML/CSS/JavaScript，学习成本高、调试复杂。
于是，Flet 出现了。
Flet 是一个使用 Python 构建现代 Web、桌面和移动应用的框架，它的目标是让开发者只使用 Python 就可以完成跨平台 UI 应用的开发。
简而言之：像写命令行脚本一样用 Python 写 Web 前端界面，跨平台自动适配。
1.1 核心特性
- 📦 纯 Python 编写 UI，无需 HTML/CSS/JS
- 🖥️ 支持 Web、桌面和移动端运行
- 🔄 实时热更新、调试体验流畅
- 🧱 内建 Material Design 组件体系
- 📡 支持多用户会话（多客户端连接）
- ☁️ 兼容 Cloud Run、Docker、Streamlit 部署方式
- ❤️ 社区活跃，开源免费（MIT License）
Flet 是基于 Flutter 的桥接层，将 Flutter 的 UI 渲染能力通过 WebSocket 绑定给 Python，使得 Python 可以驱动 Flutter 引擎生成的 UI，非常轻巧且现代化。
二、安装与快速上手
2.1 安装方式
使用 pip 安装非常方便：
pip install flet
安装后可运行：
python app.py
2.2 最简单的 Hello World 示例
import flet as ft
def main(page: ft.Page):
page.title = "Hello, Flet!"
page.add(ft.Text("Welcome to Flet!"))
ft.app(target=main)
保存为 app.py，运行后会自动打开浏览器或桌面窗口，并显示文字。
三、Flet 架构原理
3.1 底层技术栈
Flet 并不是直接用 Python 渲染前端，而是通过以下方式构建：
- 前端：Flutter 引擎生成的 Web 页面，使用 Dart 渲染 Material UI。
- 后端：Python 作为控制逻辑，构造组件、处理事件。
- 通信机制：WebSocket + JSON 数据协议连接前后端。
- 运行环境：支持浏览器、Electron 桌面、移动端 WebView。
3.2 工作流程
- 启动 Python 程序；
- 构造 UI 组件树（Page、Container、Text、Button…）；
- 启动 WebSocket 服务；
- 前端连接后解析 UI 树并渲染；
- 用户交互事件通过 WS 返回 Python；
- Python 处理逻辑并更新 UI。
Flet 相当于为 Flutter 写了一个 Python 控制接口，开发者无需了解 Dart，也能写出现代交互体验。
四、核心组件讲解
Flet 提供了与 Flutter 相似的一套组件体系，以下是常用的 UI 控件和布局组件：
4.1 页面（Page）
Page 是每个 Flet 应用的根组件：
page.title = "My App"
page.bgcolor = ft.colors.WHITE
page.padding = 10
支持属性绑定、导航栏控制、窗口尺寸等。
4.2 文本（Text）
ft.Text("Hello", size=24, weight=ft.FontWeight.BOLD)
4.3 按钮（ElevatedButton）
ft.ElevatedButton(text="Click Me", on_click=handle_click)
事件触发的回调函数接收 ControlEvent 类型：
def handle_click(e):
print("Clicked!")
4.4 输入框（TextField）
name = ft.TextField(label="Your name")
读取输入值：
print(name.value)
4.5 行列布局（Row / Column）
ft.Row([ft.Text("Left"), ft.Text("Right")])
ft.Column([ft.Text("Top"), ft.Text("Bottom")])
支持嵌套、对齐、间距等属性控制。
4.6 卡片（Card）
ft.Card(
content=ft.Container(
content=ft.Text("This is a card"),
padding=10,
bgcolor=ft.colors.BLUE_50
)
)
4.7 图像（Image）
ft.Image(src="https://example.com/photo.jpg", width=200)
4.8 列表与滚动（ListView）
ft.ListView([ft.Text(f"Item {i}") for i in range(100)], expand=True)
五、状态管理与响应式更新
Flet 的组件支持动态更新和状态绑定。
示例：计数器
def main(page: ft.Page):
counter = ft.Text("0")
def increment(e):
counter.value = str(int(counter.value) + 1)
page.update()
page.add(counter, ft.ElevatedButton("Add", on_click=increment))
关键点：
- 控件变量直接修改属性；
page.update()告知 Flet 同步 UI；- 多客户端连接时状态是隔离的。
六、多页面与路由系统
Flet 支持多页面跳转、导航栏操作：
def main(page: ft.Page):
def route_change(route):
page.views.clear()
if page.route == "/":
page.views.append(ft.View("/", [ft.Text("Home"), nav_btn]))
elif page.route == "/about":
page.views.append(ft.View("/about", [ft.Text("About page")]))
page.update()
nav_btn = ft.TextButton("About", on_click=lambda e: page.go("/about"))
page.on_route_change = route_change
page.go(page.route)
七、文件上传、图表、Dialog、动画等高级功能
7.1 文件上传
ft.FilePicker(on_result=lambda e: print(e.files))
7.2 图表（嵌入 HTML 或配合 JS 库）
ft.Iframe(src="https://charts.example.com/plot", width=600, height=400)
7.3 Dialog
dlg = ft.AlertDialog(title=ft.Text("Warning"))
page.dialog = dlg
dlg.open = True
page.update()
7.4 动画
支持控件 animate 属性：
ft.Container(content=..., animate_opacity=300, opacity=0.5)
八、部署方式
Flet 支持几种部署形式：
8.1 本地桌面应用（Electron 内嵌）
flet pack app.py
生成 .exe 或 .app。
8.2 Web 服务器
flet run app.py --web
然后部署到任何支持 Python Web 的平台（例如 Render、Fly.io、Heroku）。
8.3 Docker 部署
FROM python:3.10
RUN pip install flet
COPY app.py .
CMD ["python", "app.py"]
九、实战案例：待办清单应用
import flet as ft
def main(page: ft.Page):
tasks = ft.Column()
def add_task(e):
if not task_input.value.strip():
return
tasks.controls.append(ft.Checkbox(label=task_input.value))
task_input.value = ""
page.update()
task_input = ft.TextField(label="New Task", on_submit=add_task)
page.add(task_input, ft.ElevatedButton("Add", on_click=add_task), tasks)
ft.app(target=main)
运行后即可获得一个交互式的待办事项列表。
十、与其他框架对比
| 框架 | 语言 | 移动支持 | 桌面支持 | Web 支持 | 热更新 | 学习曲线 | 组件体系 |
|---|---|---|---|---|---|---|---|
| Flet | Python | ✅ WebView | ✅ Electron | ✅ 浏览器 | ✅ | 极低 | Flutter-style |
| Tkinter | Python | ❌ | ✅ | ❌ | ❌ | 中 | 基础 |
| Streamlit | Python | ✅（Web） | ✅（Web） | ✅ Web | ✅ | 极低 | 简洁但局限 |
| PyWebIO | Python | ✅（Web） | ❌ | ✅ Web | ✅ | 中 | 表单驱动 |
| Flutter | Dart | ✅ | ✅ | ✅ | ✅ | 高 | 极其丰富 |
Flet 在保持 Python 简洁的同时，提供了 Flutter 的现代界面体验，非常适合全栈或后端开发者快速实现可视化应用。
十一、常见问题（FAQ）
Q1：是否支持多用户在线？
是的，Flet 的每个用户连接有独立的 Page 实例。
Q2：是否可以与 Flask/FastAPI 集成？
可以，将 Flet 作为子模块运行在子线程中，主服务仍是 Flask/FastAPI。
Q3：能否控制 CSS 样式？
Flet 封装的是 Flutter 样式，通过控件属性控制布局、颜色、字体，不支持传统 CSS。
十二、未来发展与生态展望
Flet 的未来正在蓬勃发展：
- 📱 原生打包 Android/iOS App（使用 Flutter 引擎）
- 🧩 第三方控件支持与插件机制
- 🎨 自定义主题系统
- 🔧 IDE 插件与可视化构建器
- 🧠 AI Copilot 智能提示集成
对于 Python 开发者来说，Flet 正逐渐成为一套值得投资的 UI 技术栈。
十三、结语：让 Python 也能拥有漂亮的 GUI！
在过去，Python 程序员想做一个精致的前端界面常常望而却步。而今天，Flet 给我们打开了新世界的大门——一个既现代、又简洁的跨平台 UI 编程方式。
从脚本到 App，Flet 帮你用熟悉的语法打造专业的界面。
如果你是：
- Python 初学者，想做项目练手；
- 后端开发者，想做管理后台；
- 数据科学家，想构建仪表板；
- 教育从业者，想做交互学习工具；
Flet 都是你不可错过的选择。
