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

Flet 应用默认不保存数据，关闭后任务会丢失；可通过本地文件（如 JSON 或 TXT）持久化存储用户任务，无需强制认证即可实现跨会话数据保留。

Flet 应用默认不保存数据，关闭后任务会丢失；可通过本地文件（如 JSON 或 TXT）持久化存储用户任务，无需强制认证即可实现跨会话数据保留。

在使用 Flet 开发待办清单（To-Do List）类应用时，一个常见痛点是：用户添加的任务在应用关闭或刷新（Web 端）后全部消失。这是因为 Flet 的 Page 和控件状态仅存在于内存中，程序终止即清空——这不是 Bug，而是设计使然。幸运的是，我们完全可以通过轻量级本地持久化方案解决，且无需引入用户认证、数据库或后端服务。

✅ 推荐方案：使用 JSON 文件实现结构化持久化

JSON 格式清晰、易读、兼容性强，配合 Python 内置 json 模块，几行代码即可完成读写。以下是一个完整、可直接运行的实践示例：

import flet as ft
import json
import os

# 定义数据文件路径（同目录下）
DATA_FILE = "tasks.json"

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

def save_tasks(tasks):
    with open(DATA_FILE, "w", encoding="utf-8") as f:
        json.dump(tasks, f, ensure_ascii=False, indent=2)

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

    # 任务输入框与列表容器
    txt_task = ft.TextField(hint_text="输入新任务...", expand=True)
    lv_tasks = ft.ListView(expand=True, spacing=8)

    # 渲染现有任务
    def render_tasks():
        lv_tasks.controls.clear()
        for i, task in enumerate(tasks):
            lv_tasks.controls.append(
                ft.Row(
                    [
                        ft.Text(task),
                        ft.IconButton(
                            icon=ft.icons.DELETE,
                            on_click=lambda e, idx=i: delete_task(idx)
                        ),
                    ]
                )
            )
        page.update()

    def add_task(e):
        if txt_task.value.strip():
            tasks.append(txt_task.value.strip())
            save_tasks(tasks)  # ✅ 关键：立即写入文件
            txt_task.value = ""
            render_tasks()

    def delete_task(index):
        if 0 <= index < len(tasks):
            tasks.pop(index)
            save_tasks(tasks)  # ✅ 删除后同步更新文件
            render_tasks()

    # 页面布局
    page.add(
        ft.Text("? 我的待办清单（自动保存）", size=20, weight="bold"),
        ft.Row([txt_task, ft.ElevatedButton("添加", on_click=add_task)]),
        lv_tasks,
    )
    render_tasks()  # 首次渲染

ft.app(target=main)

⚠️ 注意事项与最佳实践

• 文件路径安全：生产环境建议使用 pathlib.Path.home() / "myapp" / "tasks.json" 避免权限问题；Web 端（ft.app(views=True)）因浏览器沙箱限制无法直接读写本地文件，此时需改用 session.set() + 后端 API，或前端 localStorage（需自定义 JS 交互）。
• 并发与异常：单用户本地应用通常无并发风险，但建议在 save_tasks() 中添加 try/except 捕获 IOError，避免因磁盘满或权限错误导致崩溃。
• 扩展性提示：若未来需支持多用户，可将数据结构升级为 {"user1": ["task1", "task2"], "user2": [...]}，仍用同一 JSON 文件管理，无需立即引入数据库。

? 总结：持久化 ≠ 必须登录认证。对初学者而言，JSON 文件是平衡简洁性与可靠性的最优解——它让你专注逻辑开发，同时确保用户数据“关机不丢、刷新还在”。从今天起，你的 Flet 应用就拥有了真正的记忆能力。