Python / 系统课时

把待办数据保存到本地文件

把待办数据保存到本地文件

本节解决命令行待办程序关闭后数据丢失的问题,通过 JSON 文件保存任务列表,并在启动时自动恢复数据,让程序具备最基础的持久化能力。

学习目标

  • 理解 JSON 文件持久化在小型 Python 项目中的作用。
  • 掌握使用文件读写保存和加载待办数据的方法。
  • 能够为命令行程序增加启动恢复和退出保存能力。

设计本地持久化方案

命令行程序中的任务数据通常保存在列表、字典等内存结构中。程序结束后,内存会被释放,因此下一次启动时无法继续使用之前的数据。

对于个人工具或练习项目,可以使用 JSON 文件作为简单的数据存储方式。JSON 结构清晰,能够直接映射 Python 中的列表和字典。

例如,待办数据可以保存为:

json
[
  {
    "id": 1,
    "title": "学习 Python 文件操作",
    "done": false
  }
]

程序运行流程通常变为:启动时读取文件,将 JSON 转换为 Python 对象;用户操作过程中修改内存数据;退出或保存时再次写回文件。

使用 json 模块读写任务

Python 标准库中的 json 模块提供了序列化和反序列化能力:dump() 可以把 Python 对象写入文件,load() 可以从文件恢复对象。

下面示例实现一个最小的待办存储功能:

python
import json
from pathlib import Path

DATA_FILE = Path("todos.json")


def load_todos():
    # 文件不存在时返回空列表,首次运行无需手动创建文件
    if not DATA_FILE.exists():
        return []

    with DATA_FILE.open("r", encoding="utf-8") as file:
        return json.load(file)


def save_todos(todos):
    with DATA_FILE.open("w", encoding="utf-8") as file:
        json.dump(todos, file, ensure_ascii=False, indent=2)


todos = load_todos()
todos.append({"id": 1, "title": "完成文件保存功能", "done": False})
save_todos(todos)

print(todos)

预期输出

text
[{'id': 1, 'title': '完成文件保存功能', 'done': False}]

运行结束后,当前目录会生成 todos.json 文件,下次启动程序时可以通过 load_todos() 恢复任务。

处理保存路径和数据格式

实际项目中,不建议把数据文件路径散落在代码中。可以集中定义存储位置,后续扩展为配置文件或用户目录。

保存数据时需要注意几个问题:

  • 使用 UTF-8 编码避免中文任务标题乱码。
  • 使用 indent 格式化 JSON,方便人工查看和调试。
  • 保持数据结构稳定,避免不同版本程序无法读取旧数据。

如果未来增加字段,例如任务创建时间或优先级,应考虑兼容旧文件中的缺失字段。

什么时候适合使用文件存储

JSON 文件适合单用户、小规模、低并发场景,例如学习项目、个人脚本和命令行工具。

当程序需要多人同时访问、大量数据查询、复杂条件过滤或事务保证时,应迁移到数据库,例如 SQLite、PostgreSQL 等。文件存储的价值在于简单,而不是替代专业数据库。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把待办数据保存到本地文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通