json 模組是 Python 處理 Web 資料交換的標準工具。本文進階解析 default、object_hook 定制類別序列化、__dict__ 偷懶技巧、ensure_ascii 中文處理、cls 繼承 JSONEncoder 等實戰模式。
import json
class Student:
def __init__(self, name, age, score):
self.name = name
self.age = age
self.score = score
s = Student('Bob', 20, 88)
json.dumps(s)
# TypeError: <__main__.Student object at 0x...> is not JSON serializable
def student2dict(std):
return {'name': std.name, 'age': std.age, 'score': std.score}
json.dumps(s, default=student2dict)
# '{"age": 20, "score": 88, "name": "Bob"}'
json.dumps(s, default=lambda obj: obj.__dict__)
# 同樣結果,但無法處理 __slots__ 類別
def dict2student(d):
return Student(d['name'], d['age'], d['score'])
json_str = '{"age": 20, "score": 88, "name": "Bob"}'
obj = json.loads(json_str, object_hook=dict2student)
# <__main__.Student object at 0x...>
class StudentEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, Student):
return {'__type__': 'Student', 'name': obj.name, 'age': obj.age, 'score': obj.score}
return super().default(obj)
class StudentDecoder(json.JSONDecoder):
def __init__(self, *args, **kwargs):
super().__init__(object_hook=self.dict2object, *args, **kwargs)
def dict2object(self, d):
if '__type__' in d and d['__type__'] == 'Student':
return Student(d['name'], d['age'], d['score'])
return d
# 使用
json.dumps(student, cls=StudentEncoder)
json.loads(json_str, cls=StudentDecoder)
data = {'name': '中文', 'city': '北京'}
json.dumps(data) # '{"name": "\\u4e2d\\u6587", "city": "\\u5317\\u4eac"}'
json.dumps(data, ensure_ascii=False) # '{"name": "中文", "city": "北京"}' ← 可讀、日誌友善
| 參數 | 預設 | 說明 |
|---|---|---|
indent | None | 縮排空格數,美化輸出 |
separators | (', ', ': ') | 分隔符,(',', ':') 最緊湊 |
sort_keys | False | 鍵排序,便於比較/快取 |
skipkeys | False | 跳過非字串鍵而非拋出異常 |
check_circular | True | 檢查循環引用 |
allow_nan | True | 允許 NaN/Infinity(非標準 JSON) |
from datetime import datetime
import json
class DateTimeEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, datetime):
return obj.isoformat()
return super().default(obj)
json.dumps({'time': datetime.now()}, cls=DateTimeEncoder)
# '{"time": "2024-01-15T10:30:45.123456"}'
ujson / orjson:C/Rust 實現,比標準庫快 10-50 倍orjson 預設輸出 bytes、支援 datetime、numpy、dataclass、UUIDmsgpack 或 protobuf