JSON 轉 Dart 類

用 JSON 範例建立 Dart 模型草稿

這個工具會讀取你貼上的有效 JSON，依照樣本中的欄位和值推斷 Dart 型別，並產生相應的模型程式碼。物件欄位會形成屬性，巢狀物件可形成額外型別，陣列則依其中的樣本元素推斷集合內容。輸入可以是單一物件或物件陣列；改變 JSON、型別名稱或選項後，輸出會自動更新。

例如，字串、整數、帶小數的數字與布林值可分別作為文字、整數、數值與真假欄位的推斷線索。若陣列裡有多筆代表性資料，且欄位出現情況不同，推斷時便能看見更多樣本差異。模型是對資料形狀的程式化描述，並不等同於 API 規格或伺服器端的型別保證。

JSON 是資料交換時常用的文字格式。Dart 文件說明，應用程式可將 JSON 解碼為 Dart 值，也可把支援的 Dart 值編碼回 JSON；模型類別則讓欄位結構更清楚，方便在程式中讀取與傳遞。Dart 官方 JSON 文件提供這段序列化流程的背景。

空安全與模型選項會改變輸出

Dart 的空安全區分可空與不可空型別：例如 String 表示一般字串，String? 表示欄位也可能是 null。工具提供空安全開關；是否應允許空值，應由實際資料契約決定，而不是只因範例剛好沒有出現空值就假設永遠不會出現。Dart 官方空安全說明可協助確認問號後綴的意義。

依需求可選擇只產生型別定義、使用 Freezed 相容形式、加入 Hive 型別適配器或 JSON 註解，也能調整屬性是否為 final，以及是否產生 copyWith。這些是不同的程式碼輸出選擇：使用註解或套件整合時，請再依專案所採用的套件版本與建置流程補齊設定。

從代表性資料取得可檢查的程式碼

1. 準備 JSON 樣本

   貼上有效的 JSON 物件，或放入包含多筆代表性物件的陣列。樣本應涵蓋常見欄位、可能為 null 的值，以及實際會出現的欄位組合；格式錯誤時不會產生有效輸出。

2. 命名根型別並選擇輸出

   將預設型別名稱 Root 改成專案易懂的名稱，再展開進階選項，依需求設定空安全、僅型別、Freezed、Hive、JSON 註解、final 屬性或 copyWith。未調整的選項會採用目前預設值。

3. 檢查並帶走結果

   查看生成的 Dart 程式碼，確認屬性名稱、巢狀型別、集合元素與空值標記符合預期。可使用複製或下載取得輸出，再放進專案編譯及串接測試。

格式化功能可整理輸入 JSON，範例功能會載入示範資料。若只貼一筆資料，輸出只反映那筆樣本裡看得到的欄位。

常見輸入與輸出問題

將推斷結果放進專案前先核對

輸出是依照所提供樣本推斷的程式碼草稿，不會驗證遠端 API，也無法得知未出現在樣本中的欄位、允許值、預設值或業務規則。單筆記錄、空陣列、欄位缺漏，以及同一欄位出現多種型別，都可能影響推斷；請對照正式介面文件補足 nullable 規則、命名轉換與例外處理。

選用 JSON 註解、Freezed 或 Hive 相關輸出時，依專案需要確認套件依賴、生成器設定與程式碼產物。複製或下載後應在目標 Dart／Flutter 專案中格式化、編譯並測試序列化往返，再決定是否採用。若 JSON 無法解析，先修正引號、逗號及括號等格式問題。