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 等。文件存储的价值在于简单,而不是替代专业数据库。
按自己的节奏,确认真正理解。