如何在 Flet 应用中实现任务数据的持久化存储（重启不丢失）

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

很多刚接触 Flet 的朋友，在做了第一个待办清单应用后都会遇到同一个尴尬：辛辛苦苦列好的任务，关掉窗口再打开，全没了。这其实不是 Bug，而是 Flet 的设计逻辑——页面和控件的状态只存在于内存中，程序一停，内存释放，一切归零。但话说回来，解决这个问题并不需要你立刻上数据库、搞用户认证或者搬出后端服务。用本地文件，几行代码就能搞定。

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

JSON 格式的好处不用多讲：清晰、易读、天然与 Python 数据结构兼容，配合 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 sa ve_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())
            sa ve_tasks(tasks)  # 关键：每次添加后立即写入文件
            txt_task.value = ""
            render_tasks()

    def delete_task(index):
        if 0 <= index < len(tasks):
            tasks.pop(index)
            sa ve_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 端是行不通的——浏览器沙箱机制不允许前端直接读写本地文件。如果你打算部署到 Web，那就需要改用 session.set() 配合后端 API，或者通过自定义 Ja vaScript 桥接 localStorage。

并发与异常：单用户的桌面应用基本上不存在并发冲突的风险，但磁盘满、权限不够这类意外还是有可能发生的。建议在 sa ve_tasks() 里加一层 try/except 捕获 IOError，至少别让程序因为写入失败而直接崩溃。

扩展性提示：如果后续需要支持多用户（比如家人共用一台电脑），可以在 JSON 结构上做个小调整，把数据从纯列表升级为字典——比如 {"user1": ["task1", "task2"], "user2": [...]}，用同一份文件管理不同用户的列表。这个改动很小，完全不用急着引入数据库。

总结一下：持久化不等于必须登录认证。对于初学者来说，JSON 文件是在简洁性和可靠性之间最好的平衡点——你不需要操心复杂的后端架构，就能让用户的数据做到“关机不丢、刷新还在”。从今天起，你的 Flet 应用已经有了真正的记忆能力。