工具用的順手嗎？
你的回饋能幫助我們做得更好
將JSON資料自動轉換為Flow類程式碼，簡化資料模型開發，支援自定義命名風格。
概覽
了解工具能解決的問題、計算或處理邏輯，以及資料邊界。
這項工具把一段 JSON 樣例整理成 Flow 型別程式碼，方便 JavaScript 專案先建立資料形狀的草稿。Flow 是 JavaScript 的靜態型別檢查工具；物件型別用來描述有哪些屬性，以及各屬性預期的值型別。它描述的是資料結構，不是把 JSON 資料轉成另一種檔案，也不會替你驗證欄位背後的業務規則。
例如樣例 {"name":"Lin","age":28,"active":true} 可提供字串、數字與布林值的線索；巢狀物件和陣列也會納入產生結果。工具以輸入樣例推導型別，並可設定根型別名稱；Flow 輸出是型別宣告，並非傳統物件導向語言中的資料類別。Flow 的物件型別語法及 optional 屬性規則請參考Flow 官方物件型別文件（核驗日期：2026-09-30）。
輸出內容只根據目前提供的 JSON 樣例。單一樣例沒有出現的欄位，無法據此判斷它在其他回應中是否可省略；同樣地，某欄位只出現一種值，也不代表完整介面永遠只會回傳該值。把結果當成起始型別，再依 API 文件、其他實際回應與專案需求補齊。
指南
依步驟完成操作，並透過範例核對輸入與結果。
貼上完整 JSON 文字，確認引號、逗號與括號符合 JSON 語法。若資料來自 API，先移除日誌文字、註解或多餘逗號。建議選擇具有代表性的物件回應；若有多種回應分支，先分別確認每一種形狀。
設定輸出中的根型別名稱，例如 ApiResponse。名稱會成為程式碼中的型別識別字，請使用目標 Flow 專案可接受的命名方式。
查看右側程式碼，逐一比對 JSON 的鍵名與輸出的屬性。特別留意巢狀物件、陣列元素型別、空陣列、null，以及帶有空格或連字號的鍵名。完成後可複製程式碼，或下載為以型別名稱命名的檔案。
將型別宣告放入使用中的 Flow 專案，以該專案實際設定執行 Flow 檢查，再依介面文件修正可選屬性、聯合型別與額外欄位。
例如 {"user":{"name":"Lin"},"active":true} 可示範根物件、巢狀的 user 物件和布林欄位。若 API 在其他情況會省略 user，必須根據完整契約調整型別；不要把目前樣例剛好含有該欄位，解讀為欄位一定存在。
情境
查看這項工具在不同工作與生活流程中的用法。
正在接入新端點的開發者，可貼上一份已脫敏的 JSON 回應，先取得欄位與巢狀結構的型別草稿，再對照 API 契約補上錯誤回應、選填欄位及其他分支。
維護 JSON 測試夾具的工程師，可由樣例快速整理物件屬性與陣列內容，接著在程式碼審查時核對鍵名和預期值型別。這份宣告不會代替測試案例或執行期資料驗證。
正在學習 Flow 的開發者，可以觀察字串、數字、布林值、陣列和巢狀物件在型別宣告中的呈現，再參照 Flow 文件理解 optional 屬性等需要手動補充的語法。
問答
集中解答常見疑問與容易混淆的問題。
單一樣例無法證明欄位在其他回應中可能缺席。請對照 API 文件和多種實際回應，再決定是否將屬性標為 optional；Flow 的 optional 屬性表示它可以缺省或為 void，與允許 null 並不相同。
請檢查輸出是否符合所有實際資料。單一樣例不足以涵蓋未出現的元素型別；空陣列也沒有元素可供推導。遇到 null、混合值或其他分支時，應補充型別並用 Flow 檢查器驗證。
不能直接假設相容。兩種型別系統在物件開放性、optional 屬性和其他語法規則上存在差異；若專案使用 TypeScript，請以 TypeScript 工具產生對應宣告，或轉換後交由 TypeScript 編譯器檢查。
不會。輸出是根據提供的樣例產生的靜態型別程式碼，不是執行期驗證器，也不會判斷業務規則或證明伺服器回應符合完整契約。
須知
使用前了解適用範圍、結果限制與必要提醒。
產生結果受輸入資料代表性影響；未提供的欄位、其他可能值、錯誤分支、版本差異和業務限制，都不會因為有一份型別宣告而自動補全。實際採用前請比對正式 API 文件與不同狀態的回應，特別確認 null、欄位缺省、陣列內容及鍵名改寫。型別宣告也不會在執行期間驗證收到的 JSON。若樣例含個人資料、憑證或其他機密，請先移除或遮蔽再貼上。
推薦
查找相關工具、專題與可用的 API 能力。
