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 应用就拥有了真正的记忆能力。
