JSON 轉 TypeScript 介面產生器 | fixjson.org

input.json

{
  "id": 1,
  "name": "Alice Johnson",
  "email": "alice@example.com",
  "age": 30,
  "active": true,
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "zip": "10001"
  },
  "tags": ["admin", "editor"],
  "orders": [
    { "id": 101, "total": 49.99, "status": "shipped" },
    { "id": 102, "total": 99.00, "status": "pending" }
  ]
}

types.ts

點擊轉換產生 TypeScript 介面。

相關

與 TS Types 相關的指南

全部指南 →

修復 LLM 的 JSON 輸出：處理來自 AI 的「準 JSON」

LLM 經常回傳被 ```json 圍欄包裹的 JSON，帶有單引號、Python 字面值或未加引號的鍵。修復語法，嚴格驗證，然後從清理後的輸出推導 TypeScript 型別。

修復 LLM 輸出的 JSON

AI 回應看似 JSON，但常常夾雜 markdown 圍籬、註解、Python 風格字面值或 JavaScript 物件語法。

JSON 與 JavaScript 物件字面值的差異

JSON 看起來像 JavaScript 物件字面值，但它是更小、語法更嚴格、不含可執行值的資料格式。

JSON 轉 TypeScript 的運作方式

每個 JSON 物件都會生成一個 TypeScript interface。根物件預設命名為 Root。巢狀物件會依對應的屬性鍵生成各自的具名介面 —— 名為 address 的鍵會得到一個 Address 介面。

陣列與可選欄位

物件陣列會合併所有元素中出現過的鍵。若某些項目缺少某個鍵，它就會變成可選屬性（key?: Type）。原始型別的陣列會得到帶型別的簽章，例如 string[] 或 number[]。

什麼時候用它

API 接入 —— 貼上回應主體，立刻得到可放進 TypeScript 專案的型別定義
原型階段 —— 在著手解析邏輯之前，先快速搭起對新 API 或資料集的介面骨架
程式碼審查 —— 確認 JSON 負載的形狀與程式期待的介面一致