Python 教程 / 用 json 保存数据并验证类型与金额
JSON(JavaScript Object Notation)是用于交换对象、数组、字符串和数字等结构化数据的文本格式。Python 的 json.load、dump 处理文件对象,loads、dumps 处理内存中的文本;它不是原样保存任意 Python 对象和类型的通用快照。
理解 JSON 与 Python 类型的对应
| JSON 值 | 默认读取为 Python |
|---|---|
| object | dict |
| array | list |
| string | str |
| 整数形式数字 | int |
| 小数或指数形式数字 | float |
| true、false、null | True、False、None |
JSON 的字符串与对象键使用双引号。不要把 Python 的单引号字典、注释或尾随逗号当成合法 JSON。元组序列化为数组后,默认读回会成为列表;日期与 Decimal 对象也需要明确转换策略,不能默认直接存入。
编码、解码和扩展参数见Python 官方 json 文档。读写目标文件的位置与覆盖行为,可先参考文本文件读写。
保存 Unicode 记录并读取验证
在独立练习目录将以下完整代码以 UTF-8 保存为 json_demo.py,在项目环境执行 python json_demo.py。若核对过的命令为 python3,则使用 python3 json_demo.py。它会替换 expenses-demo.json,因此请使用可丢弃的练习文件。
保留的示例用 café 作为含非 ASCII 字符的名称,便于直接观察字符表示。KRW 是记录的货币标签,本例没有执行汇率换算:
import json
from pathlib import Path
data = {"currency": "KRW", "expenses": [{"name": "café", "amount": 8000}]}
path = Path("expenses-demo.json")
path.write_text(json.dumps(data, ensure_ascii=False, indent=2, allow_nan=False), encoding="utf-8")
loaded = json.loads(path.read_text(encoding="utf-8"))
amount = loaded["expenses"][0]["amount"]
if type(amount) is not int or amount < 0:
raise ValueError("invalid amount")
print(loaded["expenses"][0]["name"])
print(amount)
预期输出:
café
8000
dumps 将 data 转为 JSON 文本,write_text 再用 UTF-8 写入文件;read_text 读回文本后,loads 恢复数据结构。程序取第一条记录的 amount,只有它恰为 int 且非负才打印。这个示例只验证已知形状中的一笔金额,不是完整的任意输入验证器。
把语法解析与业务验证分开
能够解析只表示文本能按解码规则构造数据,并不表示 expenses 一定存在、一定是列表,或列表中的每一项都有正确类型。通用导入还要验证必需键、集合形状、记录数量、金额范围与其他业务条件,不能只检查第一项。
bool是 int 的子类,所以 isinstance(True, int) 为真。本例使用 type(amount) is int,有意排除布尔值。它也会排除其他 int 子类,是否允许子类应按应用契约决定,不能认为这种写法在任何类型检查中都更合适。
allow_nan=False要求序列化时拒绝 NaN、Infinity 和 -Infinity。它不会自动使后面的 loads 采用严格的读取政策;Python 默认解码可接受某些非标准数字。外部输入还应明确如何拒绝这些常量以及如何处理重复对象键。不同来源的数据不能因为使用了这个写入选项就直接信任。
| 操作 | 主要输入与结果 |
|---|---|
| load(file) | 读取文件对象中的 JSON,返回 Python 数据 |
| loads(text) | 读取 JSON 文本,返回 Python 数据 |
| dump(obj, file) | 将 JSON 文本写入文件对象 |
| dumps(obj) | 返回 JSON 字符串,不会自动创建文件 |
不要对同一个普通 JSON 文件反复追加几个独立对象,就假设它仍是单个合法 JSON 文档。按实际协议组织成一个数组、对象或明确的记录格式,并分别验证文件生成与重新读取的结果。
区分字符表示、文件编码与错误输入
ensure_ascii=False让 café、中文等字符直接出现在 JSON 文本中,而不是统一写成 Unicode 转义;必要的引号、反斜杠和控制字符仍须转义。它不决定文件字节编码,所以代码另外指定 encoding="utf-8"。indent=2 改变排版,不改变记录含义。
- 在 Python 源码的 data 中把 8000 改成 -1,重新运行,应在业务检查处报 ValueError: invalid amount。
- 恢复金额后,将它改成 Python 的 True 再运行,也应被拒绝。注意 Python 字面值写 True,序列化后的 JSON 才写 true;不要把小写 true 直接填进 Python 源码而先触发 NameError。
- 恢复 8000,重新运行,应再次输出 café 和 8000。检查实际文件,确认重写后的数据与终端结果一致。
非法引号、尾随逗号等语法通常导致 JSONDecodeError,应修正输入而不是改用 eval。文件不存在、编码不匹配和缺少业务字段则是不同问题,应按异常和真实输入逐一诊断。外部来源的巨大输入还需按需求限制大小,解析成功也不能替代资源与数据范围控制。




