Python Flet应用实现数据持久化方法

Flet 应用默认不保存数据，关闭后任务会丢失；可通过本地文件（如 JSON 或 TXT）持久化存储用户任务，无需强制注册认证，轻量可靠，同时兼容桌面与 Web 环境。

Flet 应用默认不保存数据，关闭后任务会丢失；可通过本地文件（如 JSON 或 TXT）持久化存储用户任务，无需强制注册认证，轻量可靠，同时兼容桌面与 Web 环境。

在 Flet 中构建待办清单（To-Do List）应用时，一个常见痛点是：用户添加的任务在应用重启或浏览器刷新后全部消失。这是因为 Flet 的默认状态完全驻留在内存中——页面重建、进程终止或 Web 页面重载都会清空所有 page.controls 和变量数据。解决该问题的核心不是引入复杂的身份认证系统，而是实现数据的外部持久化存储。

✅ 推荐方案：使用 JSON 文件持久化（简洁、跨平台、易维护）

JSON 是最适配 Flet 场景的轻量级持久化方式：结构清晰、Python 原生支持（json 模块）、可读性强，且能自然映射任务列表（如 list[dict]）。相比纯文本（TXT）或独立 Python 模块（如 users.py），JSON 更安全（避免代码注入风险）、更灵活（支持嵌套字段如完成状态、创建时间），且 Web 环境下仍可通过后端或 flet 的 FilePicker 配合本地文件系统（桌面）或 IndexedDB（Web）间接支持——但对初学者，优先采用服务端无关的本地 JSON 方案（适用于桌面应用）或模拟本地存储（Web 限简单场景）。

▶ 示例：基于 tasks.json 的完整任务管理逻辑

import flet as ft
import json
import os

# 定义数据文件路径（自动创建于当前目录）
DATA_FILE = "tasks.json"

# 初始化数据：若文件不存在，创建空列表
def load_tasks():
    if os.path.exists(DATA_FILE):
        try:
            with open(DATA_FILE, "r", encoding="utf-8") as f:
                return json.load(f)
        except (json.JSONDecodeError, OSError):
            return []
    return []

def save_tasks(tasks):
    try:
        with open(DATA_FILE, "w", encoding="utf-8") as f:
            json.dump(tasks, f, ensure_ascii=False, indent=2)
    except OSError as e:
        print(f"⚠️  保存失败: {e}")

def main(page: ft.Page):
    page.title = "持久化待办清单"
    tasks = load_tasks()  # 启动时加载已有任务

    # 任务输入框
    txt_task = ft.TextField(hint_text="输入新任务...", expand=True)

    # 任务列表控件（动态更新）
    task_list = ft.Column()

    def add_task(e):
        if txt_task.value.strip():
            new_task = {
                "id": len(tasks) + 1,
                "text": txt_task.value.strip(),
                "done": False
            }
            tasks.append(new_task)
            save_tasks(tasks)  # 立即写入磁盘
            update_task_list()
            txt_task.value = ""
            page.update()

    def toggle_task(e, task_id):
        for t in tasks:
            if t["id"] == task_id:
                t["done"] = not t["done"]
                break
        save_tasks(tasks)
        update_task_list()

    def update_task_list():
        task_list.controls.clear()
        for task in tasks:
            cb = ft.Checkbox(
                label=task["text"],
                value=task["done"],
                on_change=lambda e, tid=task["id"]: toggle_task(e, tid)
            )
            task_list.controls.append(cb)
        # 确保页面响应式更新
        page.update()

    # 首次渲染任务列表
    update_task_list()

    # 页面布局
    page.add(
        ft.Text("? 我的待办清单", size=24, weight="bold"),
        ft.Row([txt_task, ft.ElevatedButton("添加", on_click=add_task)]),
        ft.Divider(),
        task_list
    )

ft.app(target=main)

✅ 关键说明：

• load_tasks() 在应用启动时读取 tasks.json，确保历史任务立即显示；
• 每次增/改操作后调用 save_tasks()，保证数据实时落盘；
• 使用 id 字段避免重复/错位（比纯索引更健壮）；
• 异常处理覆盖了文件损坏、权限不足等常见问题。

⚠️ 注意事项与进阶建议

• Web 环境限制：纯前端 Flet Web 应用无法直接写入用户设备文件系统（浏览器沙箱限制）。此时需：
  • ✅ 方案 A（推荐学习）：搭配轻量后端（如 Flask/FastAPI）提供 /api/tasks 接口，Flet 调用 page.client_storage 或 requests 通信；
  • ✅ 方案 B（快速验证）：用 page.client_storage.set("tasks", json.dumps(tasks)) 暂存（依赖浏览器 LocalStorage，非永久，但重启页面仍保留）；
• 多用户场景：若需区分用户，可在 JSON 中嵌套为 {"user1": [...], "user2": [...]}，登录后按用户名读写对应键值——无需数据库，纯文件即可支撑百人级小应用；
• 安全性提醒：避免将 users.py 作为配置文件动态导入（存在任意代码执行风险），始终优先选用 json + 显式 I/O；
• 备份意识：生产环境建议增加 save_tasks() 的原子写入（如先写临时文件再 os.replace）和定期备份逻辑。

通过以上实现，你的 Flet 待办应用便具备了真正的“记忆能力”——无论是关闭重开、崩溃恢复，还是 Web 页面刷新，任务数据都将毫发无损。坚持“数据与界面分离”原则，你已迈出了构建可靠应用的关键一步。