萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python JSON 進階用法:自訂序列化、反序列化、default/object_hook 與預設編碼陷阱

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

方案一:default 參數轉換為 dict

def student2dict(std):
    return {'name': std.name, 'age': std.age, 'score': std.score}

json.dumps(s, default=student2dict)
# '{"age": 20, "score": 88, "name": "Bob"}'

方案二:通用 __dict__ 偷懶法(適用大多數類別)

json.dumps(s, default=lambda obj: obj.__dict__)
# 同樣結果,但無法處理 __slots__ 類別

反序列化:object_hook 還原物件

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...>

進階:繼承 JSONEncoder 封裝邏輯

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)

中文編碼:ensure_ascii 參數

data = {'name': '中文', 'city': '北京'}

json.dumps(data)                    # '{"name": "\\u4e2d\\u6587", "city": "\\u5317\\u4eac"}'
json.dumps(data, ensure_ascii=False) # '{"name": "中文", "city": "北京"}'  ← 可讀、日誌友善

其他實用參數

參數預設說明
indentNone縮排空格數,美化輸出
separators(', ', ': ')分隔符,(',', ':') 最緊湊
sort_keysFalse鍵排序,便於比較/快取
skipkeysFalse跳過非字串鍵而非拋出異常
check_circularTrue檢查循環引用
allow_nanTrue允許 NaN/Infinity(非標準 JSON)

datetime 處理:擴展 JSONEncoder

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、UUID
  • 大量序列化考慮 msgpack 或 protobuf
copyright © 萬盛學電腦網 all rights reserved