JSON 轉 Python 產生器

如何將 JSON 轉換為 Python – 步驟指南

使用此 JSON 轉 Python 產生器，可從 JSON 範例產生具型別的模型/資料類，適合服務、腳本與資料管線。

1. 步驟 1 – 貼上 JSON 範例

   • 將具有代表性的 JSON 物件或陣列貼到左側編輯器。
   • 盡量包含巢狀物件、陣列與可為 null 的欄位，方便正確推斷型別。
   • 使用 匯入 從檔案、URL 或示例資料載入 JSON。

2. 步驟 2 – 選擇 Python 模型選項

   • 為產生的模型選擇根 Class Name。
   • 決定可選欄位如何表示（Optional[str]），未知型別如何表示（Any）。
   • 確認巢狀物件與清單對應到巢狀 dataclass 與 List[...]。

3. 步驟 3 – 檢查產生的程式碼

   • 確認欄位命名、型別推斷，以及陣列/物件的對應方式是否符合預期。
   • 依需求調整 根型別名稱、null 處理策略與可選的框架選項。
   • 若某些欄位推斷不準確，優化 JSON 範例後重新產生。

4. 步驟 4 – 在 Python 中使用模型

   • 將模型複製到專案模組中。
   • 載入 JSON 並映射成模型實例（手動或借助工具）。
   • 在邊界處驗證輸入（API/佇列/檔案），避免下游錯誤。

5. 步驟 5 – 複製或下載

   • 將輸出複製到專案中，或下載成檔案。
   • 執行格式化/程式碼檢查工具，讓風格與專案一致。
   • 若目標語言需要序列化/解析函式庫，請在專案中加入相依套件。

# JSON 輸入
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

# 產生的 Python 模型（簡化）
from dataclasses import dataclass
from typing import Any, List, Optional

@dataclass
class Metadata:
  plan: str

@dataclass
class Root:
  id: int
  name: str
  email: Optional[str]
  active: bool
  roles: List[str]
  metadata: Metadata
  createdAt: str
  score: float
  notes: Any

相關 JSON 與 Python 工具

探索更多可與本 JSON 轉 Python 產生器搭配使用的 JSON 與 Schema 工具。