1Tools
輸出形態
命名風格
縮排
引號
JSON
TypeScript

編碼與文字

JSON 轉 TypeScript

JSON 轉 TypeScript,就是把一份 JSON 範例轉成對應的 TypeScript 型別。把 JSON 貼到左邊,選 interface 還是 type alias,工具會自動寫出巢狀介面、陣列元素型別與選用欄位,直接貼進專案就能用。整個過程在瀏覽器完成,JSON 不會離開你的裝置。

JSON 轉 TypeScript 是從 JSON 範例推導 TypeScript 型別定義的做法,讓編譯器替你檢查資料結構,而不是執行時靠猜。

無論你叫它 JSON 轉 TS 產生器,還是 TypeScript 型別產生器,結果一樣:給既有資料一份可依賴的型別契約。

你能做什麼

  • interface 與 type 別名任選

    依團隊習慣選輸出形態。巢狀物件會產生巢狀介面,陣列會產生具名元素型別 —— JSON 轉 TypeScript 的 interface 產生器會處理深度結構,不只管最外層。

  • 辨識選用與可空欄位

    範例資料比裸 schema 攜帶更多資訊:某個欄位只在一處出現會被標成選用,同一個欄位既有值又有 null,會變成可空聯合型別。

  • 型別命名由你決定

    根型別自己取名,成員可選 PascalCase 或 camelCase,縮排可選 tab 或空格、引號可選單引號或雙引號,貼進程式庫不用二次清理。

  • 面向 API 回應與大體積

    貼一份介面回應、fixture 或設定匯出即可。深層巢狀與大陣列都能處理,輸出依概念拆分型別,而不是一坨內聯字面量。

  • 完全在瀏覽器內執行

    轉換在你自己的機器上完成,不上傳、不用註冊、不要 API key,也不留存 —— 含客戶紀錄或憑證的 payload 也能放心貼上。

怎麼用

  1. 01

    把 JSON 拿來。貼到左側編輯器,或上傳一個 .json 檔案,也可以先用內建範例看看輸出長什麼樣。

  2. 02

    選輸出形態。interface 還是 type alias、根型別叫什麼名,命名風格、縮排和引號依你現有程式庫的習慣調一下。

  3. 03

    拿走型別。複製到剪貼簿,或下載成 .ts 檔案,在需要這個資料形狀的地方直接 import。

關於 JSON 轉 TypeScript

  • JSON 轉 TypeScript 解決什麼

    JSON 範例只告訴你「現在這份資料長什麼樣」,卻不告訴程式「可以假設什麼」。JSON 轉 TS 產生器把範例變成可貼進專案的型別契約。

  • 別再靠 any 猜

    一旦 fetch 回來、賦值給變數、再傳進幾層函式,`any` 就悄悄接管 —— 欄位名寫錯不再是編譯錯誤,而是線上半夜才炸的意外。從範例產生 TypeScript,讓 `response.user.email` 由編譯器把關。

  • 巢狀物件變成具名型別

    巢狀物件會各自產生具名的 interface。`billing.address` 會得到獨立的 `Address` 型別,而不是把型別硬塞進主型別裡變成一長串內聯字面量。讀起來像人寫的程式。

  • 陣列、選用欄位與根級列表

    陣列會產生具名元素型別,`BillingAddress[]` 比重複寫 `{ street: string }[]` 好讀。有的紀錄有 `nickname`、有的沒有,該屬性就會標成選用。根級陣列也會取好根型別,輸出 `RootType[]`。 產生型別前若要先比對兩份介面回應,可先打開 JSON Diff 工具。

  • 選 interface、type 別名還是 class?

    依程式庫習慣選輸出形態。本工具產生 interface 或 type alias;class 輸出尚未提供。

    輸出適合聯合型別執行時行為說明
    interface可能被繼承或合併的物件形狀否無JSON 資料的預設輸出
    type alias聯合型別、原始型別與單一具名形狀是無欄位可能是多種型別時用
    class需要方法與執行時行為的資料是方法與欄位本工具暫不產生
  • 型別不是驗證器

    產生的型別描述的是你貼上的那份範例,不是介面的真面目。型別是編譯期契約,不是執行時保證 —— 它沒法驗證網路上真正到達的資料是否仍匹配。

  • cast 不等於檢查

    `data as User` 只是讓編譯器閉嘴。來自不受你控制的介面時,應先產生型別,再在執行時驗證。若需先清理或驗證範例,可用 JSON 格式化工具。

  • 用 JSON 範例還是 JSON Schema?

    兩條路最終都通向 TypeScript,但出發點不同。已有回應或 fixture 時,範例優先更快;已有正式描述時,schema 優先更精確 —— 有 schema 就用 schema,否則貼範例繼續做事。

    來源從何開始精度聯合型別何時使用
    JSON 範例你已有的真實資料反映範例裡出現過的內容僅範例展示出的探索介面、原型期、給 fixture 補型別
    JSON Schema允許形狀的正式描述受 schema 規則約束按宣告支援schema 已存在且必須強制

私密、快速、免費

  • 完全在瀏覽器內執行

    轉換在本機完成,不上傳,也不留存你的 JSON 副本。

  • 免註冊

    打開頁面就能轉,沒有帳號、登入和 API key。

  • 免安裝

    不用 Node.js、不用命令列、不用建置步驟,任何有瀏覽器的機器都能用。

  • 免費且不限量

    沒有試用、沒有付費牆,範例體積也不設上限。

常見問題

JSON 格式化與驗證JSON 差異比較Base64 編碼與解碼全部工具返回首頁