JSON 輸入
正在載入編輯器…
生成的 Kotlin
Configuration
輸入 JSON 資料以產生 Kotlin data class
支援 data class、kotlinx.serialization 與 null safety
JSON 轉 Kotlin 產生器
從 JSON 資料結構產生 Kotlin data class 與模型
按 Ctrl+D 收藏本工具
如何將 JSON 轉換為 Kotlin – 步驟指南
使用此 JSON 轉 Kotlin 產生器，可從 JSON 範例產生 Kotlin data class，適合 Android 與 JVM 後端專案。
步驟 1 – 貼上 JSON 範例
- 將具有代表性的 JSON 物件或陣列貼到左側編輯器。
- 盡量包含巢狀物件、陣列與可為 null 的欄位，方便正確推斷型別。
- 使用
匯入從檔案、URL 或示例資料載入 JSON。
步驟 2 – 選擇 Kotlin data class 選項
- 為產生的
data class設定根Class Name。 - 決定可為 null 的欄位如何表示（
String?、Double?等）。 - 若使用序列化函式庫，請與技術棧一致（Moshi/Kotlinx/Jackson）。
- 為產生的
步驟 3 – 檢查產生的程式碼
- 確認欄位命名、型別推斷，以及陣列/物件的對應方式是否符合預期。
- 依需求調整
根型別名稱、null 處理策略與可選的框架選項。 - 若某些欄位推斷不準確，優化 JSON 範例後重新產生。
步驟 4 – 在 Kotlin 中使用 data class
- 將 data class 放入專案的 package 路徑中。
- 使用所選函式庫將 JSON 反序列化為根型別。
- 當 API 經常變動時，建議對模型進行版本管理。
步驟 5 – 複製或下載
- 將輸出複製到專案中，或下載成檔案。
- 執行格式化/程式碼檢查工具，讓風格與專案一致。
- 若目標語言需要序列化/解析函式庫，請在專案中加入相依套件。
快速提示
- 優先使用不可變
val屬性，模型更安全。 - 欄位名不同時，使用
@Json/@SerialName等註解做對應。 - 需要跨團隊共用契約時，建議產生 JSON Schema。
範例輸出（簡化）
// 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
}
// 產生的 Kotlin data class（簡化）
data class Metadata(
val plan: String
)
data class Root(
val id: Int,
val name: String,
val email: String?,
val active: Boolean,
val roles: List<String>,
val metadata: Metadata,
val createdAt: String,
val score: Double,
val notes: Any?
)相關 JSON 與 Kotlin 工具
探索更多可與本 JSON 轉 Kotlin 產生器搭配使用的 JSON 與 Schema 工具。
常見問題
支援哪些 Kotlin 特性？
產生器會建立 Kotlin data class，支援 kotlinx.serialization、Gson 與 Jackson 註解進行 JSON 序列化，並包含 null safety、data class 等現代 Kotlin 特性。
可以產生與 kotlinx.serialization 相容的類別嗎？
可以！選擇「kotlinx」框架可產生帶有 @Serializable 與 @SerialName 的類別，支援型別安全的 JSON 序列化。
Gson 與 Jackson 整合如何運作？
選擇 Gson 或 Jackson 時，產生器會加入對應註解（@SerializedName 或 @JsonProperty），以支援正確的 JSON 序列化/反序列化。
package 結構怎麼處理？
你可以指定自訂 package 名稱，產生器會在 Kotlin 檔案頂部加入對應的 package 宣告。