Python JSON编码/解码库orjson的用法详解

pip install orjson

import orjson

data = {
    "name": "Alice",
    "age": 30,
    "hobbies": ["coding", "hiking"],
    "is_active": True
}

# 序列化为 bytes
json_bytes = orjson.dumps(data)
print(json_bytes)  # b'{"name":"Alice","age":30,...}'

# 可选：转为字符串
json_str = json_bytes.decode("utf-8")

json_data = b'{"name": "Bob", "score": 95.5}'

# 直接解析 bytes
parsed = orjson.loads(json_data)
print(parsed["name"])  # "Bob"

from datetime import datetime, timezone
from uuid import uuid4

data = {
    "id": uuid4(),  # UUID 对象
    "created_at": datetime.now(timezone.utc)  # 时区-aware datetime
}

# 直接序列化（无需自定义转换）
json_bytes = orjson.dumps(data)

json_bytes = orjson.dumps(
    data,
    option=orjson.OPT_NAIVE_UTC |   # 将无时区 datetime 视为 UTC
           orjson.OPT_SERIALIZE_NUMPY |  # 支持 numpy 数组
           orjson.OPT_SORT_KEYS     # 按键排序输出
)

# 序列化非 UTF-8 字符串（如 latin-1）
data = {"text": "café".encode("latin-1")}
json_bytes = orjson.dumps(data)  # 自动处理

import timeit
import orjson
import json

data = {"value": [i for i in range(10000)]}

# orjson 速度测试
t_orjson = timeit.timeit(lambda: orjson.dumps(data), number=1000)

# 标准库速度测试
t_stdlib = timeit.timeit(lambda: json.dumps(data), number=1000)

print(f"orjson: {t_orjson:.4f} sec")
print(f"json:   {t_stdlib:.4f} sec")

orjson: 0.02 sec
json:   0.25 sec  # 慢 10 倍以上