用 Python 构建跨平台 GUI 与 Web 应用：Flet 框架实战

实战代码示例

1. 最简单的窗口

创建一个包含文本的窗口，这是最基础的 Hello World。

import flet as ft

def main(page: ft.Page):
    page.add(ft.Text("Hello, Flet!"))

ft.app(target=main)

2. 交互：按钮点击

演示如何添加事件监听器，当用户点击按钮时动态更新页面内容。

import flet as ft

def main(page: ft.Page):
    def on_click(e):
        page.add(ft.Text("按钮被点击"))

    page.add(ft.ElevatedButton("点我", on_click=on_click))

ft.app(target=main)

3. 表单输入与反馈

结合输入框和按钮，获取用户输入并即时反馈。

import flet as ft

def main(page: ft.Page):
    name = ft.TextField(label="请输入姓名")

    def update_name(e):
        page.add(ft.Text(f"你好，{name.value}"))

    page.add(name, ft.ElevatedButton("确认", on_click=update_name))

ft.app(target=main)

4. 布局控制

使用 Row 和 Container 进行简单的左右布局。

import flet as ft

def main(page: ft.Page):
    page.add(
        ft.Row([
            ft.Container(ft.Text("左"), width=100,),
            ft.Container(ft.Text("右"), width=100,)
        ])
    )

ft.app(target=main)

5. 运行模式

默认情况下，Flet 会尝试打开本地窗口。若需强制以 Web 浏览器模式运行，可指定 view 参数。

ft.app(target=main, view=ft.WEB_BROWSER)

API 速览

为了方便查阅，这里列出几个最常用的类和方法：

• ft.app(target, view=None)：启动应用。target 是主函数，view 决定运行视图（桌面、Web 等）。
• Page：主页面对象。常用属性包括 title（标题）、controls（控件列表）、theme_mode（主题）。方法有 add()（添加控件）、update()（刷新）、go(route)（路由跳转）。
• Text(value)：文本控件，接受字符串。
• TextField(label=None)：输入框，支持标签提示。
• ElevatedButton(text, on_click=None)：按钮，支持点击回调。
• Row/Column(controls)：布局容器，接受子控件列表。
• Container(content, padding, bgcolor, expand=False)：通用容器，用于控制样式和间距。

补充说明

在实际使用中，有几个关键点需要注意：

1. 性能优势：底层依赖 Flutter 渲染，UI 性能远超 Tkinter 或 PySimpleGUI。
2. 架构特点：Python 层不直接绘图，而是通过 WebSocket 与前端通信，实际渲染由前端完成。
3. 打包发布：支持使用 Flet CLI 将应用打包为桌面程序。
4. 移动端现状：虽然支持移动端，但在部署流程和最终性能上仍在持续优化中。
5. 适用边界：非常适合快速开发和内部工具，但对于超大型复杂前端项目，可能不如原生 Web 方案成熟。

总结

Flet 让 Python 开发者能够以较低的学习成本构建现代、跨平台的 GUI 与 Web 应用。凭借 Flutter 的高性能渲染和丰富的控件体系，它在内部工具、实时仪表盘、企业管理界面等高交互场景中表现优异。简单的事件机制、响应式布局和'纯 Python 无需前端'的开发模式，使其成为当前 Python 生态中最具潜力的跨平台 UI 框架之一。