你可以将这个 JSON 对象封装为一个 Python 类（例如 `FileMetadata`），推荐使用 `dataclass`（简洁、类型安全、适合数据载体），并支持时间戳转为可读日期（如 `datetime`）： ### ✅ 推荐写法（Python 3.7+）： ```python from dataclasses import dataclass from datetime import datetime from typing import Optional @dataclass class FileMetadata: id: str name: str size: int extension: str mime_type: str created_by: str created_at: int # Unix timestamp (seconds since epoch) preview_url: Optional[str] @property def created_datetime(self) -> datetime: """将 created_at 时间戳转为 datetime 对象""" return datetime.fromtimestamp(self.created_at) def to_dict(self) -> dict: """转为字典（便于序列化或调试）""" return { "id": self.id, "name": self.name, "size": self.size, "extension": self.extension, "mime_type": self.mime_type, "created_by": self.created_by, "created_at": self.created_at, "preview_url": self.preview_url, } # ✅ 使用示例： data = { "id": "d62e8413-4452-4bee-ac51-710d9117fba6", "name": "202603190933404135.pdf", "size": 101159, "extension": "pdf", "mime_type": "application/pdf", "created_by": "83b22077-603f-41ca-aa33-55c64de8f373", "created_at": 1773900243, "preview_url": None } file = FileMetadata(**data) print(file.name) # 202603190933404135.pdf print(file.created_datetime) # 2026-03-19 09:33:40.000000（取决于系统时区） ``` > 💡 提示：`created_at=1773900243` 对应的是 **UTC 时间 `2026-03-19 01:33:40`**；`datetime.fromtimestamp()` 默认用本地时区，如需 UTC，请用 `datetime.utcfromtimestamp()` 或 `datetime.fromtimestamp(ts, tz=timezone.utc)`。 --- ### 🔁 补充：如果想自动处理 `null` → `None` 和类型校验，可升级为 Pydantic v2（更健壮，适合 API/校验场景）： ```python from pydantic import BaseModel from datetime import datetime from typing import Optional class FileMetadata(BaseModel): id: str name: str size: int extension: str mime_type: str created_by: str created_at: int preview_url: Optional[str] = None @property def created_datetime(self) -> datetime: return datetime.fromtimestamp(self.created_at) ``` ✅ 支持自动类型转换、校验、JSON 序列化（`.model_dump()` / `.model_dump_json()`）。 --- 需要我帮你： - 自动生成对应 TypeScript / Java / Go 类？ - 写成 SQLAlchemy ORM 模型？ - 加入文件校验逻辑（如 `is_pdf`, `is_too_large`）？ - 或解析 `created_at` 为指定时区（如 `"Asia/Shanghai"`）？ 欢迎随时告诉我 😊